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第 3 版 的 变化 
读者 对 象 
本 书 内 容 
资源 下 载 
致谢 
第 1 章 开始 启程 ,你 的 第 一 行 Android 代 码 
1.1 了 解 全 貌 ，Android 王 国 简介 
1.1.1 Android 系 统 架 构 
1.1.2 Android 已 发 布 的 版 本 
1.1.3 Android 应 用 开发 特色 
1.2 手把手 带 你 搭建 开发 环境 
1.2.1 准备 所 需要 的 工具 
1.2.2 ”搭建 开发 环境 
1.3 创建 你 的 第 一 个 Android 项 目 
1.3.1 创建 HelloWorld 项 目 
1.3.2 ”启动 模拟 器 
1.3.3 运行 HelloWorld 
1.3.4 分 析 你 的 第 一 个 Android 程 序 
1.3.5 详解 项 目 中 的 资源 
1.3.6 详解 build.gradle 文 件 
1.4 前 行 必 备 : 掌握 日 志 工 具 的 使 用 
1.4.1 使 用 Android 的 日 志 工 具 Log 
1.4.2 为 什么 使 用 Log 而 不 使 用 println() 
1.5 小结 与 点 评 
第 2 章 探究 新 语言 , 快速 入 门 Kotlin 编 程 
2.1 Kotlin 语 言 简介 
2.2 如何 运行 Kotlin 代 码 
2.3 编程 之 本 : 变量 和 函数 
2.3.1 变量 
2.3.2 函数 
2.4 程序 的 逻辑 控制 
2.4.1 if 条 件 语 名 
2.4.2 When 条 件 语句 
2.4.3 ”循环 语句 
2.5 面向 对 象 编程 
2.5.1 类 与 对 象 
2.5.2 ”继承 与 构造 水 数 
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2.5.3 接口 
2.5.4 数据 类 与 单 例 类 
2.6 Lambda 编 程 
2.6.1 集合 的 创建 与 遍历 
2.6.2 集合 的 函数 式 API 
2.6.3 Java 函 数 式 API 的 使 用 
2.7 ” 空 指针 检查 
2.7.1 可 空 类 型 系统 
2.7.2， 判 空 情 助 工具 
2.8 Kotlin 中 的 小 魔术 
2.8.1 字符 串 内 栓 表 达 式 
2.8.2 ”函数 的 参数 默认 值 
2.9 ”小 结 与 点 评 
第 3 章 ” 先 从 看 得 全 的 入 手 ， 探究 Activity 
3.1 Activity 是 什么 
3.2 ”Activity 的 基本 用 法 
3.2.1 手动 创建 Activity 
3.2.2 ”创建 和 加 载 布局 
3.2.3 在 AndroidManifest 文 件 中 注册 
3.2.4 在 Activity 中 使 用 Toast 
3.2.5 在 Activity 中 使 用 Menu 
3.2.6 ”销毁 一 个 Activity 
3.3 使 用 Intent 在 Activity 之 间 穿 梭 
3.3.1 使 用 显 式 Intent 
3.3.2 使 用 隐 式 Intent 
3.3.3 ”更 多 隐 式 Intent 的 用 法 
3.3.4 向 下 一 个 Activity 传 递 数据 
3.3.5 ”返回 数据 给 上 一 个 Activity 
3.4 Activity 的 生命 周期 
3.4.1 返回 栈 
3.4.2 Activity 状 态 
3.4.3 Activity 的 生存 期 
3.4.4 体验 Activity 的 生命 周期 
3.4.5 Activity 被 回收 了 怎么 办 
3.5 _ Activity 的 启动 模式 
3.5.1 Standard 
3.5.2 singleTop 
3.5.3 singleTask 
3.5.4 Singlelnstance 
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3.6 Activity 的 最 佳 实践 
3.6.1 知晓 当前 是 在 哪 一 个 Activity 
3.6.2 ”随时 随地 退出 程序 
3.6.3 ”启动 Activity 的 最 佳 写法 
3.7 ”Kotlin 课 堂 : 标准 函数 和 静态 方法 
3.7.1 标准 函数 with、run 和 apply 
3.7.2 ”定义 静态 方法 
3.8 ”小 结 与 点 评 
第 4 章 软件 也 要 拼 脸 蛋 ,UI 开发 的 点 点 滴 滴 
4.1 该 如 何 编写 程序 界面 
4.2 常用 控件 的 使 用 方法 
4.2.1 TextView 
4.2.2 Button 
4.2.3 EditText 
4.2.4 ImageView 
4.2.5 ProgressBar 
4.2.6 AlertDialog 
4.3 详解 3 种 基本 布局 
4.3.1 LinearLayout 
4.3.2 RelativeLayout 
4.3.3 FrameLayout 
4.4 ”系统 控件 不 够 用 ? 创建 自 定 义 控件 
4.4.,1 引入 布局 
4.4.2 ”创建 自 定义 控件 
4.5 最 常用 和 最 难 用 的 控件 : ListView 
4.5.1 ListView 的 简单 用 法 
4.5.2 定制 ListView 的 界面 
4.5.3 提升 ListView 的 运行 效率 
4.5.4 ListView 的 点 击 事件 
4.6 ”更 强大 的 滚动 控件 : RecyclerView 
4.6.1 RecyclerView 的 基本 用 法 
4.6.2 ”实现 横向 滚动 和 瀑布 流 布局 
4.6.3 RecyclerView 的 点 击 事件 
4.7” 编 与 界面 的 最 佳 实践 
4.7.1 制作 9-Patch 图 片 
4.7.2 编写 精美 的 聊天 界面 
4.8 Kotlin 课 堂 : 延迟 初始 化 和 密封 类 
4.8.1 对 变量 延迟 初始 化 
4.8.2 ”使 用 密封 类 优化 代码 
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4.9 ”小 结 与 点 评 
第 5 章 手机 平板 要 兼顾 ,探究 Fragment 
5.1 Fragment 是 什么 
5.2 ” Fragment 的 使 用 方式 
5.2.1 ” Fragment 的 简单 用 法 
5.2.2 动态 添加 Fragment 
5.2.3 在 Fragment 中 实现 返回 栈 
5.2.4 Fragment 和 Activity 之 间 的 交互 
5.3 Fragment 的 生命 周期 
5.3.1 Fragment 的 状态 和 回调 
5.3.2 体验 Fragment 的 生命 周期 
5.4 动态 加 载 布局 的 技巧 
5.4.1 使 用 限定 符 
5.4.2 ”使 用 最 小 宽度 限定 符 
5.5 ” Fragment 的 最 佳 实践 : 一 个 简易 版 的 新 闻 应 用 
5.6 ”Kotlin 课 堂 : 扩展 函数 和 运算 符 重 载 
5.6.1 大 有 用 途 的 扩展 函数 
5.6.2 ”有趣 的 运算 符 重 载 
5.7 小结 与 点 评 
第 6 章 全 局 大 喇叭 ， 详 解 广播 机 制 | 
6.1 广播 机 制 简 介 
6.2 接收 系统 广播 
6.2.1 动态 注册 监听 时 间 变 化 
6.2.2 静态 注册 实现 开机 启动 
6.3 发送 自 定义 广播 
6.3.1 发 送 标准 广播 
6.3.2 发 送 有 序 广播 
6.4 广播 的 最 佳 实践 : 实现 强制 下 线 功 能 
6.5 Kotlin 课 堂 : 高 阶 函 数 详解 
6.5.1 定义 高 阶 函 数 
6.5.2 ”内 联 函数 的 作用 
6.5.3 noinline 与 crossinline 
6.6 ”Git 时 间 : 初 识 版 本 控制 工具 
6.6.1 安装 Git 
6.6.2 ”创建 代码 仓库 
6.6.3 ”提交 本 地 代码 
6.7 小结 与 点 评 
第 7 章 数据 存储 全 方案 ， 详 解 持久 化 技术 
7.1 持久 化 技术 简介 
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7.3 


7.4 


了 


7.6 


了 


第 8 章 


8.1 
8.2 


8:3 


8.4 


8.5 


8.6 


第 9 章 


文件 存储 

7.2.1 将 数据 存储 到 文件 中 

7.2.2 ”从 文件 中 读 取 数 据 
SharedPreferences 存 储 

7.3.1 将 数据 存储 到 SharedPreferences 中 
7.3.2 从 SharedPreferences 中 读 取 数据 
7.3.3 ”实现 记 住 密码 功能 
SQLite 数 据 库存 储 

7.4.1 创建 数据 库 

7.4.2 ”升级 数据 库 

7.4.3 添加 数据 

7.4.4 更 新 数据 

7.4.5 ”删除 数据 

7.4.6 查询 数据 

7.4.7 ”使 用 SQL 操作 数据 库 
SQLite 数 据 库 的 最 佳 实践 

7.5.1 使 用 事务 

7.5.2 ”升级 数据 库 的 最 佳 写 法 
Kotlin 课 堂 : 高 阶 函 数 的 应 用 

7.6.1 简化 SharedPreferences 的 用 法 
7.6.2 简化 ContentValues 的 用 法 
小 结 与 点 评 

跨 程序 共享 数据 , 探究 ContentProvider 
ContentProvider 人 简介 

运行 时 权限 

8.2.1 Android 权 限 机 制 详 解 

8.2.2 在 程序 运行 时 申请 权限 

访问 其 他 程序 中 的 数据 

8.3.1 ContentResolver 的 基本 用 法 
8.3.2 读 取 系统 联系 人 

创建 自己 的 ContentProvider 

8.4.1 创建 ContentProvider 的 步骤 
8.4.2 ”实现 跨 程序 数据 共享 
Kotlin 课 堂 : 泛 型 和 委托 

8.5.1 泛 型 的 基本 用 法 

8.5.2 ”类 委托 和 委托 属性 

8.5.3 ”实现 一 个 自己 的 lazy 水 数 
小 结 与 点 评 

丰富 你 的 程序 ， 运 用 手机 多 媒体 
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9.1 将 程序 运行 到 于 机 上 
9.2 使 用 通知 
9.2.1 创建 通知 渠道 
9.2.2 通知 的 基本 用 法 
9.2.3 通知 的 进 阶 技巧 
9.3 调用 摄像 头 和 相册 
9.3.1 调用 摄像 头 拍照 
9.3.2 ”从 相册 中 选择 图 片 
9.4 播放 多 媒体 文件 
9.4.1 播放 音频 
9.4.2 播放 视频 
9.5 ”Kotlin 课 堂 : 使 用 infix 国 数 构建 更 可 读 的 语法 
9.6 ”Git 时 间 : 版 本 控制 工具 进 阶 
9.6.1 忽略 文件 
9.6.2 ”查看 修改 内 容 
9.6.3 ”撤销 未 提交 的 修改 
9.6.4 查看 提交 记录 
9.7 ”小结 与 点 评 
第 10 章 ”后台 默默 的 劳动 者 ， 探 究 Service 
10.1 Service 是 什么 
10.2 Android 多 线程 编程 
10.2.1 线程 的 基本 用 法 
10.2.2 在 子 线程 中 更 新 UI 
10.2.3 解析 异步 消息 处 理 机 制 | 
10.2.4 使 用 AsyncTask 
10.3 Service 的 基本 用 法 
10.3.1 定义 一 个 Service 
10.3.2 ”启动 和 停止 Service 
10.3.3 Activity 和 Service 进 行 通信 
10.4 Service 的 生命 周期 
10.5 Service 的 更 多 技巧 
10.5.1 使 用 前 台 Service 
10.5.2 使 用 IntentService 
10.6 ”Kotlin 课 堂 : 泛 型 的 高 级 特性 
10.6.1 对 泛 型 进行 实 化 
10.6.2” 泛 型 实 化 的 应 用 
10.6.3 泛 型 的 协 变 
10.6.4 泛 型 的 逆 变 
10.7 “小 结 与 点 评 
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第 11 章 ”看 看 精彩 的 世界 ， 使 用 网 络 技术 
11.1 WebView 的 用 法 
11.2 使 用 HTTP 访 问 网 络 
11.2.1 使 用 HttpURLConnection 
11.2.2 使 用 OkHttp 
11.3 解析 XML 格式 数据 
11.3.1 Pull 解析 方式 
11.3.2 SAX 解析 方 式 
11.4 解析 JSON 格 式 数 据 
11.4.1 使 用 SONObject 
11.4.2 使 用 GSON 
11.5 ”网 络 请 求 回调 的 实现 方式 
11.6 最 好 用 的 网 络 库 : Retrofit 
11.6.1 Retrofit 的 基本 用 法 
11.6.2 ”处理 复杂 的 接口 地 址 类 型 
11.6.3 ”Retrofit 构 建 器 的 最 佳 写法 
11.7 ”Kotlin 课 堂 : 使 用 协 程 编 写 高 效 的 并 发 程序 
11.7.1 协 程 的 基本 用 法 
11.7.2 更 多 的 作用 域 构建 怖 
11.7.3 使 用 协 程 简化 回调 的 与 法 
11.8 小 结 与 点 评 
第 12 章 最 佳 的 UI 体 验 ,Material Design 实 战 
12.1 什么 是 Material Design 
12.2 Toolbar 
12.3 滑动 菜单 
12.3.1 DrawerLayout 
12.3.2 NavigationView 
12.4 悬浮 按钮 和 可 交互 提示 
12.4.1 _ FloatingActionButton 
12.4.2 Snackbar 
12.4.3 CoordinatorLayout 
12.5 卡片 式 布局 
12.5.1 MaterialCardView 
12.5.2 AppBarLayout 
12.6 ”下拉 刷 新 
12.7 可 折合 式 标题 栏 
12.7.1 CollapsingToolbarLayout 
12.7.2 ”充分 利用 系统 状态 栏 空间 
12.8 ”Kotlin 课 堂 : 编写 好 用 的 工具 方法 
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12.8.1 求 N 个 数 的 最 大 最 小 值 
12.8.2 简化 Toast 的 用 法 
12.8.3 简化 Snackbar 的 用 法 
12.9 Git 时间 : 版 本 控制 工具 的 高 级 用 法 
12.9.1 分 支 的 用 法 
12.9.2 与 远程 版 本 库 协作 
12.10 小结 与 点 评 
第 13 章 ”高 级 程序 开发 组 件 ， 探究 Jetpack 
13.1 jetpack 简 介 
13.2 ViewModel 
13.2.1 ViewModel 的 基本 用 法 
13.2.2 向 ViewModel 传 递 参 数 
13.3 Lifecycles 
13.4 LiveData 
13.4.1 LiveData 的 基本 用 法 
13.4.2 map 和 和 switchMap 
13.5 Room 
13.5.1 使 用 Room 进行 增删 改 查 
13.5.2 Room 的 数据 库 升级 
13.6 WorkManager 
13.6.1 WorkManager 的 基本 用 法 
13.6.2 使 用 WorkManager 处 理 复杂 的 任务 
13.7 ”Kotlin 课 堂 : 使 用 DSL 构 建 专 有 的 语法 结构 
13.8 ”小 结 与 点 评 
第 14 章 ”继续 进 阶 ,你 还 应 该 掌握 的 高 级 技巧 
14.1 全 局 获取 Context 的 技巧 
14.2 ”使 用 Intent 传 递 对 象 
14.2.1 Serializable 方 式 
14.2.2 ”Parcelable 方 式 
14.3 定制 自己 的 日 志 工 具 
14.4 调试 Android 程 序 
14.5 深 色 主题 
14.6 ”Kotlin 课 堂 : Java 与 Kotlin 代 码 之 间 的 转换 
14.7 总 结 
第 15 章 进入 实战 ,开发 一 个 天 气 预 报 App 
15.1 功能 需求 及 技术 可 行 性 分 析 
15.2 ”Git 时 间 : 将 代码 托管 到 GitHub 上 
15.3 搭建 MVVM 项 目 架 构 
15.4 搜索 全 球 城 市 数据 
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15.4.1 实现 逻辑 层 代 码 
15.4.2 ”实现 UI 层 代码 

15.5， 显 示 天 气 信 息 
15.5.1 ”实现 逻辑 层 代 码 
15.5.2 ”实现 UI 层 代 码 
15.5.3 记录 选中 的 城市 

15.6 手动 刷新 天 气 和 切换 城市 
15.6.1 手动 刷新 天 气 
15.6.2 切换 城市 

15.7 制作 App 的 图 标 

15.8 生成 正式 签名 的 APK 文 件 
15.8.1 使 用 Android Studio 生 成 
15.8.2 使 用 Gradle 生 成 

15.9 ”你 还 可 以 做 的 事情 

第 16 章 编写 并 发 布 一 个 开源 库 ,' PermissionX 

16.1 开发 前 的 准备 工作 

16.2 ”实现 PermissionX 开 源 库 

16.3 ”对 开源 库 进行 测试 

16.4 将 开源 库 发 布 到 jcenter 仓 库 

16.5 ”体验 我 们 的 成 果 

16.6 结束语 

作者 简介 
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个 人 -一 一 
月 百 


虽然 我 从 事 Android 开发 工作 已 经 很 多 年 了 ， 但 是 之 前 从 来 没有 想 过 自己 要 去 与 一 本 Android 
技术 相关 的 书 。 在 我 看 来 ， 写 一 本 书 可 以 算是 一 个 很 庞大 的 工程 ， 与 一 本 好 书 的 难度 并 不 亚 于 
开发 一 款 好 的 应 用 程序 。 


由 于 我 长 期 坚持 在 CSDN 上 发 表 技术 博文 ， 因 而 得 到 了 大 量 网 友 的 认可 ， 也 积累 了 一 定 的 名 
气 。 很 荣幸 的 是 ， 人民 邮 电 出 版 社 图 灵 公 司 的 前 副 总 编辑 陈 冰 老师 联系 上 了 我 ， 希望 我 可 以 写 
一 本 关于 Android 开发 技术 的 书 ， 这 着 实 让 我 受宠若惊 。 


在 写本 书 前 两 版 的 时 候 ,我 可 以 说 是 费 了 相当 大 的 心思 。 写 书 和 写 博 客 最 大 的 区 别 在 于 ， 书 的 
内 容 不 能 像 博客 那样 散乱 ， 不 能 想到 哪里 与 到 哪里 ， 而 是 一 定 要 系统 化 ， 要 循序 渐进 ， 基 本 上 
在 与 第 1 章 的 时 候 就 应 该 把 全 书 的 内 容 都 确定 下 来 了 。 


令 我 非常 欣慰 的 是 ， 本 书 的 前 两 版 在 推出 之 后 都 获得 了 广大 读者 的 强烈 认可 ， 目 前 已 经 成 为 了 

国内 最 畅销 的 Android 技术 书 。 各 大 书店 、 图 书馆 都 能 看 到 《第 一 行 代码 一 一 Android》 的 身 
影 ， 许 多 学 校 和 培训 机 构 也 纷纷 将 其 选 为 Android 课程 的 教材 ， 甚 至 《第 一 行 代码 》 已 经 成 为 
了 本 书 的 代名词 。 


不 过 ， 在 科技 高 速 发 展 的 今天 ， 各 种 技术 的 发 展 都 是 日 新 月 异 的 。 在 本 书 第 2 版 推出 后 的 3 年 
时 间 里 ，Android 操作 系统 经 历 了 8.0、9.0、10.0 的 飞速 升级 ， 同 时 Google 公司 推荐 的 
Android 程序 开发 语言 也 从 java 变 成 了 Kotlin。 不 可 否认 的 是 ， 本 书 第 2 版 中 的 不 少 知识 点 
已 经 过 时 ,而且 这 3 年 间 出 现 了 很 多 新 知识 ， 第 2 版 中 也 没有 涵盖 。 因 此 ， 这 让 我 坚定 了 写作 
本 书 第 3 版 的 想法 。 


由 于 涉及 语言 的 变更 ， 这 次 我 将 书 中 原来 所 有 的 java 代码 都 进行 了 重 写 ， 改 用 Kotlin 语言 进 

行 实现 。 另 外 考虑 到 很 多 读者 朋友 之 前 可 能 并 没有 接触 过 Kotlin , 在 第 3 版 中 我 特别 加 入 了 许 

多 Kotlin 语言 方面 的 讲解 ， 因 此 这 更 像 是 一 本 Android + Kotlin 的 综合 技术 书 。 此 外 ， 这些 

年 Android 系统 的 各 个 版 本 都 增加 了 很 多 革新 的 特性 ， 还 出 现 了 诸如 Jetpack、MVVM 等 全 新 
的 技术 , 第 3 版 将 这 些 内 容 全 部 涵盖 了 进去 。 毫 不 夸张 地 说 ， 我 几乎 重 写 了 整 本 书 。 

而 现在 ， 你 手中 捧 着 的 正 是 全 新 版 的 《第 一 行 代码 一 一 Android》 , 同时 这 可 能 也 是 国内 第 一 本 


基于 Android 10.0 系统 写作 的 技术 书 。 我 真诚 地 希望 你 可 以 用 心地 阅读 这 本 书 ， 因 为 每 多 掌 
握 一 份 知识 ， 你 就 会 多 一 份 喜悦 。Enjoy it! 
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第 3 版 的 变化 
由 于 第 3 版 修改 内 容 繁多 ， 因 此 这 里 我 只 列举 出 最 主要 的 变化 。 


首先 是 编程 语言 上 的 改变 ， 本 书 前 两 版 都 是 使 用 Java 作为 应 用 程序 的 开发 语言 ， 而 第 3 版 使 
用 了 Kotlin， 这 是 目前 Google 公司 最 推荐 我 们 使 用 的 开发 语言 。 

本 书 的 前 两 版 中 也 没有 涉及 过 语言 方面 的 讲解 ， 默 认 读者 是 有 java 语言 基础 的 。 而 第 3 版 中 
对 Kotlin 语言 进行 了 非常 全 面 的 讲解 ， 不 需要 读者 有 任何 Kotlin 语言 的 基础 。 


另外 ,本 书 第 1 版 是 基于 Android 4.Xx 系统 的 ， 第 2 版 是 基于 Android 7.0 系统 的 ， 现 在 第 
3 版 基于 Android 10.0 系统 。 其 中 囊括 了 新 系统 中 的 诸多 知识 点 ， 包 括 Android 8.0 系统 中 
引入 的 通知 渠道 和 应 用 图 标 适 配 、Android 9.0 系统 中 引入 的 明文 网 络 传输 限制 适 配 、 
Android 10.0 系统 中 引入 的 深 色 主题 模式 等 。 


除 此 之 外 ， 第 3 版 还 加 入 了 两 个 实战 项 目 以 及 Retrofit、 协 程 、jetpack、MVVM 等 全 新 知识 
点 的 讲解 ， 内 容 将 前 所 未 有 地 充实 。 


www.blogss.cn 


读者 对 象 

本 书 内 容 通俗 易 懂 ， 由 浅 入 深 , 既 适 合 初 学 者 学 习 ， 又 适合 专业 人 员 阅 读 。 学 习 本 书 内 容 之 

前 ， 你 并 不 需要 有 任何 Android 或 Kotlin 方面 的 基础 ， 但 是 最 好 有 一 定 的 Java 基础 。 虽 然 本 
书 是 使 用 Kotlin 语言 来 进行 开发 的 ， 但 是 Kotlin 是 一 门 基 于 java 的 语言 ， 如果 你 对 Java 有 
所 了 解 的 话 ， 将 会 非常 有 助 于 Kotlin 语言 的 学 习 。 

阅读 本 书 时 ， 你 可 以 根据 自身 的 情况 来 决定 如 何 阅读 。 如 果 你 是 初学 者 的 话 ， 建 议 从 第 1 章 开 
始 循序 渐进 地 阅读 ， 这 样 理解 起 来 就 不 会 感到 吃力 。 而 如 果 你 已 经 有 了 一 定 的 Android 基础 ， 

那么 就 可 以 选择 某 些 你 感 兴趣 的 章节 进行 跳跃 式 的 阅读 。 但 请 记 住 ， 很 多 章 最 后 的 最 佳 实践 以 

及 Kotlin 课堂 一 定 是 你 不 想 错过 的 。 
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本 书 内 容 


正如 前 面 所 说 ， 本 书 的 内 容 是 非常 系统 化 的 ， 不仅 全 面 介绍 了 那些 你 必须 掌握 的 知识 ， 而 且 保 
证 了 各 章 的 难度 都 是 梯度 式 上 升 的 。 全 书 一 共 分 为 16 章 ，Android 方面 涵盖 了 四 大 组 件 、 
UI、Fragment、 数 据 存储 、 多 媒体 、 网 络 、 架 构 等 应 用 层面 的 知识 。Kotlin 方面 涵盖 了 基础 
语法 、 常 用 技巧 、 高 阶 函 数 、 泛 型 、 协 程 、DSL 等 语言 层面 的 知识 。 另 外 ,为 了 让 你 在 学 完 所 
有 内 容 之 后 进一步 提升 综合 运用 的 能 力 ， 本 书 的 尾声 部 分 还 会 带 你 一 起 开发 一 个 天 气 预报 程 
序 , 以 及 编写 并 发 布 一 个 开源 库 。 


除 此 之 外 ， 本 书 的 第 6 章 、 第 9 章 、 第 12 章 、 第 15 章 中 穿插 了 对 Git 的 讲解 ， 如 果 想 要 掌 
握 它 的 用 法 ， 这 几 章 的 内 容 是 绝对 不 能 错过 的 。 


本 书 中 各 个 章节 的 内 容 相对 比较 独立 ， 因 此 除了 可 以 循序 渐进 地 学 习 之 外 ， 你 还 可 以 把 它 当成 
一 本 参考 手册 ,随时 查阅 。 
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资源 下 载 


首先 ， 为 了 方便 你 的 学 习 ， 本 书 提供 了 书 中 所 有 项 目的 源码 ， 建 议 仪 在 需要 的 时 候 再 去 参考 

(例如 获取 项 目 中 的 图 片 资源 ) 。 最 好 的 学 习 方式 肯定 是 将 所 有 的 项 目 都 亲手 敲 上 一 遍 ， 因 为 
只 有 这 样 ， 才 能 加 深 你 对 代码 的 理解 。 切 勿 直接 将 源码 复制 粘贴 就 当成 是 自己 的 东西 了 ,只 
亲手 训 过 的 代码 才 真 正 是 你 自己 的 。 


其 次 ,本 书 提供 了 Android 和 Kotlin 思维 导 图 。 思 维 导 图 可 以 方便 你 纵览 Android 和 Kotlin 
的 宏观 图 景 ， 帮助 你 梳理 各 章 的 知识 要 点 ， 了 解 详 尽 的 知识 脉络 。 


最 后 ， 本 书 前 两 版 被 大 量 高 校 当 作 教 材 使 用 ,这 次 为 了 便于 高 校 教师 和 培训 机 构 教学 , 第 3 版 
中 专门 配备 了 相应 的 PPT 课件 。 


以 上 所 有 资源 ,你 都 可 以 到 图 灵 社 区 本 书 官方 主页 的 “ 随 书 下 载 " 中 下 载 ， 你 也 可 以 关注 我 的 微 
信 公 众 号 ( 见 封面 二 维 码 ) ， 回 复 “ 随 书 资源 "获取 下 载 地 址 。 
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勘误 

尽管 我 和 编辑 张 起 已 经 尽 可 能 地 对 本 书 进行 了 仔细 的 校对 ， 但 书 中 仍然 难免 存在 一 些 未 发 现 的 
错误 。 这 些 错 误 一 旦 后 期 被 确认 都 会 提交 到 图 灵 社 区 本 书 官 方 主页 , 你 可 以 在 这 里 查看 所 有 已 
知 的 错误 。 如 果 你 在 阅读 时 发 现 了 一 些 还 未 被 提交 和 确认 的 错误 ， 也 欢迎 你 主动 进行 提交 ， 编 
辑 确认 之 后 ， 你 将 能 领 到 图 灵 社 区 的 银子 ， 可 以 免费 竞 换 一 些 图 灵 的 图 书 。 
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致谢 


在 这 近 一 年 的 时 间 里 ， 我 又 完成 了 一 项 浩大 的 工程 。 和 写作 本 书 前 两 版 时 的 感觉 类 似 ， 当 全 书 
完稿 之 后 ， 回顾 整 本 书 ， 我 仍然 不 敢 相信 这 所 有 的 内 容 竟 然 是 我 一 字 字 敲 出 来 的 。 


如 今 这 已 经 是 我 写 的 第 三 本 书 了 ， 我 深 知 出 版 一 本 书 有 多 么 不 容易 ， 出 版 一 本 被 广大 读者 朋友 
们 认可 的 好 书 则 更 加 不 容易 。 因 此 ， 我 要 在 这 里 对 很 多 人 表示 感谢 。 


首先 我 要 感谢 本 书 第 1 版 的 编辑 陈 冰 老 师 ， 如 果 没 有 你 当初 在 CSDN 上 找到 我 ， 并 邀请 我 写 书 ， 
就 不 会 有 现在 的 《第 一 行 代码 一 一 Android》。 另 外 ， 你 也 是 当时 唯一 一 个 坚信 这 本 书 一 定 会 大 
卖 的 人 ， 甚至 连 我 自己 当时 都 没有 如 此 的 眼光 。 


我 也 非常 感谢 本 书 第 2 版 、 第 3 版 的 编辑 张震， 你 全 程 负责 了 本 书 的 出 版 工作 ， 并 且 完 成 得 非常 
出 色 。 你 对 文字 的 把 控 能 力 让 我 敬佩 ， 感 谢 你 对 书 中 每 一 章节 的 尽心 审阅 ， 才 能 让 这 本 书 更 趋 
近 于 完美 。 

另外 我 还 要 特别 感谢 一 部 分 人 ， 你 们 在 对 本 书 的 内 容 建议 、 勘 误 检 查 、 代 码 纠 错 等 方面 都 做 出 


了 卓越 的 页 献 。 有 了 你 们 的 帮助 ， 才 会 有 这 样 一 本 更 加 出 色 的 书 呈现 在 所 有 人 面前 ， 这 本 书 上 
也 理应 有 你 们 的 名 字 ( 按 姓氏 拼音 排序 ， 排 名 不 分 先后 ) : 


陈 建 林 、 陈 俊杰 、 陈 雷 、 陈 龙 、 陈 琪 、 代 云 蛟 、 段 郭 森 、 高 太 稳 、 黄 楠 、 赖 帆 、 李 建 友 、 李 


潭 、 李 永 鹏 、 林 火 荣 、 刘 朝 、 刘 治国 、 罗 亚 超 、 吕 国 佬 、 沈 立 涛 、 孙 建 《、 王 杰 、 王 龙 、 王 路 
路 、 王 鹏 、 王 荣 宗 、 王 善 昌 、 吴 波 、 吴 绍 志 、 张 鸿 洋 、 赵 庆 元 、 郑 敏 馨 、 周 苏 、 庄 育 锋 。 
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第 1 章 开始 局 程 , 你 的 第 一 行 Android 代 码 


欢迎 你 来 到 Android 世 界 ! Android 系 统 是 目前 世界 上 市 场 占有 率 最 高 的 移动 操作 系统 ， 不 管 你 
在 哪里 ， 都 可 以 看 到 Android 手 机 几乎 无 处 不 在 。 今 天 的 Android 世 界 可 谓 欣 欣 向 菏 ， 可 是 你 知 
道 它 的 过 去 是 什么 样 的 吗 ? 我 们 一 起 来 看 一 看 它 的 发 展 史 吧 。 


2003 年 10 月 ,Andy Rubin 等 人 一 起 创办 了 Android 公 司 。2005 年 8 月 ，Google 公 司 收购 了 
这 家 仅仅 成 立 了 22 个 月 的 公司 ， 并 让 Andy Rubin 继 续 负责 Android 项 目 。 在 经 过 了 数 年 的 研发 
之 后 ,Google 终于 在 2008 年 推出 了 Android 系 统 的 第 一 个 版 本 。 但 自 那 之 后 ,Android 的 发 展 
就 一 直 受 到 重重 阻挠 。 弄 布 斯 自始至终 认为 Android 是 一 个 抄 佬 iPhone 的 产品 ， 里 面 列 穷 了 诸 
多 iPhone 的 创意 ,并 声称 一 定 要 毁 掉 Android。 而 本 身 就 是 基于 Linux 开 发 的 Android 操 作 系 
统 ,在 2010 年 被 Linux 团 队 从 Linux 内 核 主 线 中 除名 。 由 于 Android 中 的 应 用 程序 一 开始 都 是 使 
用 java 开 发 的 ,甲骨 文公 司 针对 Android 侵 犯 Jjava 知 识 产权 一 事 对 Google 提 起 了 诉讼 ,……. 


可 是 ， 似 乎 再 多 的 困难 也 阻挡 不 了 Android 快 速 前 进 的 步伐 。 由 于 Google 的 开放 政策 ,任何 手 
机 厂商 和 个 人 都 能 免费 获取 Android 操 作 系统 的 源码 ， 并 且 可 以 自由 地 使 用 和 定制 。 三 星 、 
HTC、 摩 托 罗 拉 、 索 爱 等 公司 相继 推出 了 各 自 系 列 的 Android 手 机 ,， Android 市 场 上 百花 齐 放 。 
仅仅 在 推出 两 年 后 , Android 就 超过 了 已 经 霸占 市 场 逾 十 年 的 诺基亚 Symbian， 成 为 了 全 球 第 
一 大 智能 手机 操作 系统 ， 并且 每 天 还 会 有 数 百 万 台新 的 Android 设 备 被 激活 。 而 近 几 年 ， 国 内 的 
手机 厂商 也 大 放 异 彩 ， 小 米 、 华 为 、 魅 族 等 新 兴 品 牌 都 推出 了 相当 不 错 的 Android 手 机 ， 并 且 获 
得 了 市 场 的 广泛 认可 ,目前 Android 已 经 占据 了 全 球 智能 手机 操作 系统 70% 以 上 的 份额 。 
说 了 这 些 ， 想 必 你 已 经 体会 到 Android 系 统 和 炙手可热 的 程度 ， 并 且 和 迫不及待 地 想 要 加 入 Android 
开发 者 的 行列 了 吧 。 试 想 一 下 ,10 个 人 中 有 7 个 人 的 手机 可 以 运行 你 编写 的 应 用 程序 ， 还 有 什么 
能 比 这 个 更 诱 人 的 呢 ? 那么 从 今天 起 ,我 就 带 你 踏 上 学 习 Android 的 旅途 ， 一步 步 引导 你 成 为 一 
名 出 色 的 Android 开 发 者 。 


好 了 ， 现 在 我 们 就 来 一 起 初 宪 一 下 Android 世 界 吧 。 
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1.1 了 解 全 Android 王国 简介 


Android 从 面世 以 来 到 现在 已 经 发 布 了 20 多 个 版 本 了 。 在 这 几 年 的 发 展 过 程 中 ， Google 为 
Android 王 国 建立 了 一 个 完整 的 生态 系统 。 手 机 厂商 、 开 发 者 、 用 户 之 间 相 互 依存 ， 共同 推进 着 
Android 的 蓬勃 发 展 。 开 发 者 在 其 中 扮演 着 不 可 或 缺 的 角色 ， 因 为 如 果 没 有 开发 者 来 制作 丰 高 的 
应 用 程序 ， 那 么 不 管 多 么 优秀 的 操作 系统 ， 也 是 难以 得 到 大 众 用 户 喜爱 的 ， 相 信 没 有 多 少 人 能 
够 忍受 没有 QQ、 微 信 的 手机 吧 。 而 且 ，Google 推 出 的 Google Play 更 是 给 开发 者 带 来 了 大 量 
的 机 遇 , 只 要 你 能 制作 出 优秀 的 产品 , 在 Google Play 上 获得 了 用 户 的 认可 ， 你 就 完全 可 以 得 到 
不 错 的 经 济 回报 ， 从 而 成 为 一 名 独立 开发 者 ， 甚 至 是 成 功 创业 ! 


那 我 们 现在 就 从 一 个 开发 者 的 角度 ， 去 了 解 一 下 这 个 操作 系统 吧 。 纯 理论 型 的 东西 会 比较 无 
聊 ， 怕 你 看 睡 着 了 ， 因 此 我 只 挑 重点 介绍 ， 这些 东西 跟 你 以 后 的 开发 工作 都 是 息息相关 的 。 


1.1.1 Android 系 统 架 构 


为 了 让 你 能 够 更 好 地 理解 Android 系 统 是 怎么 工作 的 ， 我 们 先 来 看 一 下 它 的 系统 架构 。Android 
大 致 可 以 分 为 4 层 染 构 : Linux 内 核 层 、 系 统 运行 库 层 、 应 用 框架 层 和 应 用 层 。 


01. Linux 内 核 层 


Android 系 统 是 基于 Linux 内 核 的 ， 这 一 层 为 Android 设 备 的 各 种 硬件 提供 了 底层 的 驱动 ， 
如 显示 驱动 、 音 频 驱 动 、 照 相机 驱动 、 蓝 牙 驱动 、Wi-Fi 驱 动 、 电 源 管理 等 。 


02. 系统 运行 库 层 


这 一 层 通 过 一 些 C/C++ 库 为 Android 系 统 提供 了 主要 的 特性 支持 。 如 SQLite 库 提供 了 数据 
库 的 支持 ,OpenGLIES 库 提供 了 3D 绘 图 的 支持 ，Webkit 库 提供 了 浏览 器 内 核 的 支持 等 。 
在 这 一 层 还 有 Android 运 行 时 库 ， 它 主要 提供 了 一 些 核心 库 ， 允许 开发 者 使 用 ava 语 言 
编写 Android 应 用 。 另 外 ，Android 运 行 时 库 中 还 包含 了 Dalvik 虚 拟 机 (5.0 系 统 之 后 改 为 
ART 运 行 环 境 ) ， 它 使 得 每 一 个 Android 应 用 都 能 运行 在 独立 的 进程 中 ， 并 且 拥 有 一 个 自己 
的 虚拟 机 实例 。 相 较 于 Java 虚拟 机 ，Dalvik 和 ART 都 是 专门 为 移动 设备 定制 的 ， 它 针对 手 
机 内 存 、CPU 性 能 有 限 等 情况 做 了 优化 处 理 。 


03. 应 用 框架 层 


这 一 层 主要 提供 了 构建 应 用 程序 时 可 能 用 到 的 各 种 AP , Android 自 带 的 一 些 核心 应 用 就 是 
使 用 这 些 API 完 成 的 ， 开 发 者 可 以 使 用 这 些 API 来 构建 自己 的 应 用 程序 。 


04. 应 用 层 


所 有 安装 在 手机 上 的 应 用 程序 都 是 属于 这 一 层 的 ， 比 如 系统 自 带 的 联系 人 、 短 信 等 程序 ， 
或 者 是 你 从 Google Play 上 下 载 的 小 游戏 ,当然 还 包括 你 自己 开发 的 程序 。 


结合 图 1.1 你 将 会 理解 得 更 加 深刻 。 


www.blogss.cn 


APPLICATIONS 


Home Contacts Phone Browser 


APPLICATION FRAMEVORK 


Activity Window Content View Notification 


Manager Manager Providers System Manager 


Package Telephony Resource Location XMPP 
Manager Manager Manager Manager Service 


LIBRARIES ANDROID RUNTIME 


Surface Media Ee Core 
已 
Manager Framework Libraries 


OpenGLIES FreeType WebKit Wu 
y Machine 


GL 


LINUX KERNEL 


Display a Bluetooth Flash Memory Binder (IPC) 
Driver Driver Driver 


USB WiFi Audio )\ 
Driver Driver Drivers Management 


图 1.1 Android 系 统 架 构 (图 片 源 自 维基 百科 ) 
1.1.2 Android 已 发 布 的 版 本 


2008 年 9 月 ，Google 正 式 发 布 了 Android 1.0 系 统 ， 这 也 是 Android 系 统 最 早 的 版 本 。 随 后 的 
几 年 ,Google 以 惊人 的 速度 不 断 地 更 新 Android 系 统 ，2.1、2.2、2.3 系 统 的 推出 使 Android 
占据 了 大 量 的 市 场 。2011 年 2 月 ,Google 发 布 了 Android 3.0 系 统 ， 这 个 系统 版 本 是 专门 为 平 
板 计算 机 (简称 “平板 ”) 设计 的 ,但 也 是 Android 为 数 不 多 的 比较 失败 的 版 本 , 推出 之 后 一 直 不 
见 什 么 起 色 ， 市 场 份额 也 少 得 可 怜 。 不 过 很 快 ， 在 同年 的 10 月 ，Google 又 发 布 了 Android 4.0 
系统 ,这 个 版 本 不 再 对 手机 和 平板 进行 差异 化 区 分 ， 既 可 以 应 用 在 手机 上 , 也 可 以 应 用 在 平板 
上 。2014 年 Google 推 出 了 号 称 史 上 版 本 改动 最 大 的 Android 5.0 系 统 ， 使 用 ART 运 行 环境 替代 
了 Dalvik 虚 拟 机 ， 大 大 提升 了 应 用 的 运行 速度 ,还 提出 了 Material Design 的 概念 来 优化 应 用 
的 界面 设计 。 除 此 之 外 ,还 推出 了 Android Wear、Android Auto、Android TV 系统 ,从 而 进 
军 可 穿戴 设备 、 汽 车 、 电 视 等 全 新 领域 。 之 后 Android 的 更 新 速度 更 加 迅速 ， 每 年 都 会 发 布 一 个 
新 版 本 ,到 2019 年 Android 已 经 发 布 到 10.0 系 统 了 , 这 也 是 本 书 编写 时 最 新 的 系统 版 本 。 


表 1.1 列 出 了 目前 主要 的 Android 系 统 版 本 及 其 详细 信息 。 当 你 看 到 这 张 表格 时 ， 数 据 可 能 已 经 
发 生 了 变化 ， 查 看 最 新 的 数据 可 以 访问 
http://developerandroid.google.cn/about/dashboards。 


表 1.1 Android 系统 版 本 及 其 详细 信息 


版 本 号 系统 代号 API 市 场 占有 率 
2 2 Gingerbread 10 0.3% 
4.0.3 ~ 4.0.4 Ice Cream Sandwich 15 0.3% 
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4.1.X Jelly Bean 

4.2.X 

4.3 

4.4 KitKat 19 6.9% 

5.0 有 21 3% 
Lollipop 


11.5% 


Marshmallow 23 16.9% 
7.0 24 11.4% 
Nougat 
7 25 7.8% 


12.9% 


Oreo 


从 表 1.1 中 可 以 看 出 ， 目 前 5.0 以 上 的 系统 已 经 占据 了 超过 85% 的 Android 市 场 份额 ， 并 且 这 个 
数字 还 会 继续 扩大 ， 因 此 我 们 本 书 中 开发 的 程序 也 只 面向 5.0 以 上 的 系统 ， 更 早 的 系统 版 本 就 不 
再 去 兼容 了 。 


1.1.3 Android 应 用 开发 特色 
预告 一 下 ， 你 马上 就 要 开始 真正 的 Android 开 发 旅程 了 7。 不 过 别 着 急 ， 在 开始 之 前 我 们 先 来 一 起 


看 一 看 ,Android 系 统 到 底 提供 了 哪些 东西 ， 可 供 我 们 开发 出 优秀 的 应 用 程序 。 
01. 四 大 组 件 


02. 


03. 


04. 


Android 系 统 四 大 组 件 分 别 是 Activity、Service、BroadcastReceiver 和 
ContentProvider。 其 中 Activity 是 所 有 Android 应 用 程序 的 门面 ， 几 是 在 应 用 中 你 看 得 到 
的 东西 ， 都 是 放 在 Activity 中 的 。 而 Service 就 比较 低调 了 ， 你 无 法 看 到 它 ， 但 它 会 在 后 台 
默默 地 运行 ， 即 使 用 户 退 出 了 应 用 ,Service 仍 然 是 可 以 继续 运行 的 。 
BroadcastReceiver 人 允许 你 的 应 用 接收 来 自 各 处 的 广播 消息 ， 比 如 电话 、 短 信 等 ， 当 然 ， 
你 的 应 用 也 可 以 向 外 发 出 广播 消息 。ContentProvider 则 为 应 用 程序 之 间 共 享 数据 提供 了 
可 能 ， 比 如 你 想 要 读 取 系 统 通讯 录 中 的 联系 人 ， 就 需要 通过 ContentProvider 来 实现 。 


丰富 的 系统 控件 


Android 系 统 为 开发 者 提供 了 丰富 的 系统 控件 ， 使 得 我 们 可 以 很 轻松 地 编写 出 漂亮 的 界面 。 
当然 如 果 你 品位 比较 高 ， 不 满足 于 系统 自 带 的 控件 效果 ， 完全 可 以 定制 属于 自己 的 控件 。 


SQLite 数 据 库 

Android 系 统 还 自 带 了 这 种 轻 量 级 、 运 算 速度 极 快 的 能 入 式 关 系 型 数据 库 。 它 不 仅 支 持 标 准 
的 SQL 语法 ， 还 可 以 通过 Android 封 装 好 的 API 进 行 操 作 ， 让 存储 和 读 取 数据 变 得 非常 方 
便 。 


强大 的 多 媒体 
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Android 系 统 还 提供 了 丰富 的 多 媒体 服务 ， 如 音乐 、 视 频 、 录 音 、 拍 照 等 ， 这 一 切 你 都 可 以 
在 程序 中 通过 代码 进行 控制 ， 让 你 的 应 用 变 得 更 加 丰富 多 彩 。 
既然 有 Android 这 样 出 色 的 系统 给 我 们 提供 了 这 人 么 丰 语 的 工具 ， 你 还 用 担心 做 不 出 优秀 的 应 


用 吗 ? 好 了 ， 纯 理论 的 东西 就 介绍 到 这 里 ， 我 知道 你 已 经 迫不及待 地 想 要 开始 真正 的 开发 
之 旅 了 ， 那 我 们 就 启程 吧 ! 
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1.2 手把手 带 你 搭建 开发 环境 


俗话 说 得 好 ，“ 工 欲 善 其 事 ， 必 先 利 其 器 ”, 开 着 记事 本 就 想 去 开发 Android 程 序 显然 不 是 明智 之 
举 ， 选择 一 个 好 的 IDE 可 以 极 大 地 提高 你 的 开发 效率 ， 因 此 本 节 我 就 手把手 地 带 着 你 把 开发 环境 
搭建 起 来 。 


1.2.1 准备 所 需要 的 工具 
开发 Android 程 序 需要 准备 的 工具 主要 有 以 下 3 个 。 


。JDK。JDK 是 java 语 言 的 软件 开发 工具 包 , 它 包 含 了 java 的 运行 环境 、 工 具 集合 、 基 础 类 库 
等 内 容 。 

。Android SDK。Android SDK 是 Google 提 供 的 Android 开 发 工具 包 ， 在 开发 Android 程 
序 时 ， 我 们 需要 通过 引入 该 工具 包 来 使 用 Android 相 关 的 APl。 

。 Android Studio。 在 很 时 之 前 ,Android 项 目 都 是 使 用 Eclipse 来 开发 的 ,相信 所 有 java 
开发 者 都 一 定 会 对 这 个 工具 非常 熟悉 , 它 是 Java 开发 神器 ， 安 装 ADT 插 件 后 就 可 以 用 来 开 
发 Android 程 序 了 。 而 在 2013 年 ，Google 推 出 了 一 款 官方 的 IDE 工 具 Android Studio ， 
由 于 不 再 是 以 插件 的 形式 存在 , Android Studio 在 开发 Android 程 序 方面 要 远 比 Eclipse 强 
大 和 方便 得 多 ， 因 此 本 书 中 所 有 的 代码 都 将 在 Android Studio 上 进行 开发 。 


1.2.2 搭建 开发 环境 


当然 ， 上 述 软件 并 不 需要 一 个 个 地 下 载 ， 为 了 简化 搭建 开发 环境 的 过 程 ，Google 将 所 有 需要 用 
到 的 工具 都 帮 我 们 集成 好 了 ， 到 Android 官 网 就 可 以 下 载 最 新 的 开发 工具 ， 下 载 地 址 是 : 
https://developer.android.google.cn/studio。 不 过 ，Android 官 网 有 时 访问 会 不 太 稳 定 ， 
如 果 你 无 法 访问 上 述 网 址 ,也 可 以 到 一 些 国内 的 代理 站 点 进行 下 载 ， 比 如 : 
http://www.android-studio.org。 


你 下 载 下 来 的 将 是 一 个 安装 包 ， 安装 的 过 程 也 很 简单 ， 基 本 上 一 直 点 击 “Next" 就 可 以 了 。 其 中 
在 安装 的 过 程 中 有 可 能 会 弹出 如 图 1.2 所 示 的 对 话 框 。 


[2 22 Android Studio First Run 


er Unable to access Android SDK add-on list 


图 1.2 无 法 访问 add-on list 的 警告 对 话 框 
这 个 对 话 框 是 在 询问 我 们 ， 无 法 访问 Android SDK 的 add-on list， 是否 要 配置 代理 。 由 于 我 们 


使 用 的 网 络 访问 Google 的 一 些 服务 是 受到 限制 的 ， 因 此 才 会 弹出 这 样 一 个 对 话 框 。 不 过 这 并 不 
影响 我 们 接 下 来 的 环境 搭建 ， 因 此 直接 点 击 “Cancel" 就 可 以 了 。 
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之 后 一 直 点 击 “Next”, 直到 完成 安装 ， 然 后 启动 Android Studio。 首 次 启动 会 让 你 选择 是 否 导 
入 之 前 Android Studio 版 本 的 配置 ， 由 于 这 是 我 们 首次 安装 ， 选 择 不 导入 即 可 ， 如 图 1.3 所 
示 。 

堵 EE Import Android Studio Settings From... 


() Config or installation folder: 


© Do not import settings 


图 1.3 ”选择 不 导入 配置 
点 击 “OK" 按钮 会 进入 Android Studio 的 配置 界面 ， 如 图 1.4 所 示 。 


四 局 @ Android Studio Setup Wizard 


Welcome 


/以 Android Studio 


Welcome back! This setup wizard will validate your current Android SDK and 
development environment setup. You will have the option to download a new Android 
SDK or use an existing installation. Once the setup wizard completes, you can 
import an existing Android app into Android Studio or start a new Android project. 


站 口 LJ 同 国 


Cancel Previous 
图 1.4 Android Studio 的 配置 界面 
然后 点 击 “Next" 开 始 进行 具体 的 配置 ， 如 图 1.5 所 示 。 
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© Android Studio Setup Wizard 


A Install Type 


Choose the type of setup you want for Android Studio: 


© standard 
Android Studio will be installed with the most common settings and options. 
Recommended for most users. 
Custom 
You can customize installation settings and components installed. 


Cancel Previous 


图 1.5 ”选择 安装 类 型 


这 里 我 们 可 以 选择 Android Studio 的 安装 类 型 ,， 有 Standard 和 Custom 两 种 。Standard 表 示 
一 切 都 使 用 默认 的 配置 ， 比较 方便 ; Custom 则 可 以 根据 用 户 的 特殊 需求 进行 自 定义 。 简 单 起 
见 ， 这 里 我 们 就 选择 Standard 类 型 了 。 继 续 点 击 “Next” 会 让 你 选择 Android Studio 的 主题 风 
格 ， 如 图 1.6 所 示 。 


Oe Android Studio Setup Wizard 


A 人 Select UI Theme 


Darcula © Light 
>» Ml src , @ HelloWorld 
lloWworld.java 


mport javax.Swing,.*; 
mport javax.awt.«*; 


wblic class Helloworld { 
public Helloworld() { 
JFrame frame = new JFrame ("Hello we 
JLabel label = new JLabel!(); 
label. setFont (new Font("Serif", Fonm 


label. @ 

frame. 

framel + ls] [a] 回 
frames 网 二 |ine Rreaknninte 


Cancel Previous 
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图 1.6 选择 Android Studio 的 主题 风格 


Android studio 内置 了 深 色 和 浅 色 两 种 风格 的 主题 ， 你 可 以 根据 自己 的 喜好 选择 。 这 里 我 就 选 
择 默认 的 浅 色 主 题 了 ， 继 续 点 击 “Next" 完 成 配置 工作 ， 如 图 1.7 所 示 。 


@@e Android Studio Setup Wizard 


A Verify Settings 


f you want to review or change any of your installation settings, click Previous. 


Current Settings: 


Setup Type: 
Standard 


SDK Folder: 
/Users/guolin/Library/Android/sdk 


Total Download Size: 
619 KB 


SDK Components to Download: 
Intel x86 Emulator Accelerator (HAXM installer) 619 KB 


Cancel Previous Next 


图 1.7 完成 Android Studio 配 置 


现在 点 击 “Finish” 按 钮 ， 配置 工 作 就 全 部 完成 了 。 然 后 Android Studio 会 尝试 联网 下 载 一 些 更 
新 ， 等 待 更 新 完成 后 再 点 击 “Finish” 按 钮 ， 就 会 进入 Android Studio 的 欢迎 界面 ， 如 图 1.8 所 


不 。 
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@@ 四 Welcome to Android Studio 


人 


Androld Studlo 


十 Start a new Android Studio project 

蕊 Open an existing Android Studio project 
片 Check out project from Version Control 
后 Profile or debug APK 

以 Import project (Gradle, Eclipse ADT, etc.) 


Ee¥ Import an Android code sample 


你 Configure v Get Help ~ 


图 1.8 Android Studio 的 欢迎 界面 


目前 为 止 , Android 开 发 环境 就 已 经 全 部 搭建 完成 了 。 那 现在 应 该 做 什么 呢 ? 当然 是 写 下 你 的 第 
一 行 Android 代 码 了 ， 让 我 们 快 点 开始 吧 。 


www.blogss.cn 


1.3 ”创建 你 的 第 一 个 Android 项 目 


任何 一 个 编程 语言 写 出 的 第 一 个 程序 之 无 疑问 都 是 Hello World ,这 是 自 20 世 纪 70 年 代 流 传 下 
来 的 传统 ， 在 编程 界 已 成 为 永恒 的 经 典 ， 那 我 们 当然 也 不 会 搞 例 外 了 。 
1.3.1 创建 HelloWorld 项 目 


在 Android Studio 的 欢迎 界面 点 击 “Start a new Android Studio project”, 会 打开 一 个 让 你 
选择 项 目 类 型 的 界面 ,如 图 1.9 所 示 。 


© @ Create New Project 
Choose your project 


Phone and Tablet Wear OS TV Android Auto Android Things 


Add No Activity 


Basic Activity Empty Activity Bottom Navigation Activity 
Fragment + ViewModel Fullscreen Activity Master/Detail Flow Navigation Drawer Activity 


Empty Activity 


Creates a new empty activity 


图 1.9 ”选择 项 目 类 型 界面 


这 里 我 们 不 仅 可 以 选择 创建 手机 和 平板 类 型 的 项 目 ， 还 可 以 选择 创建 可 穿戴 设备 、 电 视 ， 甚 至 
汽车 等 类 型 的 项 目 。 不 过 手机 和 平板 才 是 本 书 讨论 的 重点 ， 其 他 类 型 的 项 目 我 们 就 不 去 关注 
了 。 另 外 , Android Studio 还 提供 了 很 多 种 内 置 模板 ， 不 过 由 于 我 们 才刚 刚 开始 学 习 ， 用 不 着 
这 么 多 复杂 的 模板 ， 这 里 直接 选择 “Empty Activity”， 创建 一 个 空 的 Activity 就 可 以 了 。 


点 击 “Next" 会 进入 项 目 配置 界面 , 如 图 1.10 所 示 。 
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EE ® Create New Project 
Configure your project 
Name 
HelloWorld 


Package name 
com.example.helloworld 


Save location 


/Users/guolin/AndroidStudioProjects/AndroidFirstLine/HelloWorld 


Language 


Kotlin 


Minimum APllevel API 21: Android 5.0 (Lollipop) 


Empty Activity 加 Your app will run on approximately 85.0% of devices. 


Help me choose 


This project will support instant apps 


Creates a new empty activity 


Cancel Previous 
图 1.10 项 目 配置 界面 
其 中 , Name 表 示 项 目 名 称 ， 这 里 我 们 填 入 “HelloWorld" 即 可 。 


Package name 表 示 项 目的 包 名 ，Android 系 统 就 是 通过 包 名 来 区 分 不 同 应 用 程序 的 ， 因 此 包 
名 一 定 要 具有 唯一 性 。Android Studio 会 根据 应 用 名 称 来 自动 帮 我 们 生成 合适 的 包 名 ， 如 果 你 
不 想 使 用 默认 生成 的 包 名 ,也 可 以 自行 修改 。 


Save location 表 示 项 目 代 码 存放 的 位 置 ， 如果 没有 特殊 要 求 的 话 ， 这 里 也 保持 默认 即 可 。 


接 下 来 的 Language 就 很 重要 了 ， 这 里 默认 选择 了 Kotlin。 在 过 去 ，Android 应 用 程序 只 能 使 用 
Java 来 进行 开发 ， 本 书 的 前 两 个 版 本 也 都 是 用 Java 语 言 讲解 的 。 然 而 在 2017 年 ，Google 引 入 
了 一 款 新 的 开发 语言 一 一 Kotlin， 并 在 2019 年 正式 向 广大 开发 者 公布 了 Kotlin First 的 消息 。 
此 , 本 书 第 3 版 决定 响应 Google 的 号 召 ， 全 书 代码 都 使 用 Kotlin 语 言 来 进行 编写 。 那 么 你 可 能 

会 担心 了 ， 我 不 会 Kotlin 怎 么 四? 没关系 ， 本 书 除了 会 讲解 Android 方 面 的 知识 之 外 ， 还 会 非常 
全 面 地 讲解 Kotlin 方 面 的 知识 ， 并 不 需要 你 有 任何 Kotlin 语 言 的 基础 。 


紧 接着 ，Minimum API level 可 以 设置 项 目的 最 低 兼 容 版 本 。 前 面 已 经 说 过 ，Android 5.0 以 
上 的 系统 已 经 占据 了 超过 85% 的 Android 市 场 份额 ， 因 此 这 里 我 们 将 Minimum SDK 指 定 成 API 
21 就 可 以 了 。 


最 后 的 两 个 复 选 框 ， 一 个 是 用 于 支持 instant apps 免 安装 应 用 的 ， 这 个 功能 必须 配合 Google 
Play 服务 才能 使 用 ， 在 国内 是 用 不 了 的 ， 因 此 不 在 本 书 的 讨论 范围 内 ; 另 一 个 用 于 在 项 目 中 局 
用 AndroidX。AndroidX 的 主要 目的 是 取代 过 去 的 Android Support Library， 虽 然 Google 给 
出 了 一 个 过 渡 期 ， 但 是 在 我 使 用 的 Android Studio 3.5.2 版 本 中 ， 这 个 复 选 框 已 经 被 强制 勾 选 
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了 。 如 果 你 使 用 了 更 新 的 Android Studio 版 本 ， 看 不 到 这 个 复 选 框 也 不 用 感到 奇怪 ， 因 为 未 来 
所 有 项 目 都 会 默认 启用 AndroidX。 想 要 了 解 更 多 AndroidX 与 Android Support Library 的 区 
别 ， 可 以 关注 我 的 微 信 公 众 号 ( 见 封面 ) ， 回 复 “AndroidX"“ 即 可 。 

现在 点 击 “Finish” 按 钮 ， 并 耐心 等 待 一 会 儿 ， 项 目 就 会 创建 成 功 了 ， 如 图 1.11 所 示 。 


©®0e HelloWorld [~/AndroidStudioProjects/AndroidFirstLine/HelloWorld] - .../app/src/main/java/com/example/helloworld/MainActivity.kt [app] 


HelloWorld Wsapp Msrc Mmain Mjava Dlcom Blexample A wapp v | Nodevices v Pb 着 0 匣 时 器 坟 凡 QQ 
§ 项 Android v 加 三 次 一 户 activity_mainxml 三 MainActivity.kt ow 
在 sapp package com.example.helloworld ve 
En] Ml manifests i 对 
而 Mi java I 
5 com.example.helloworld 器 class MainActivity : AppCompatActivity() { 
例 MainActivity 
站 com.example.helloworld (androidTest) 对 override fun onCreate(savedInstanceState: Bundle?) { 
各 a tt super,onCreate(savedInstanceState) 
ey com.example.helloworld (test) setContentView(R, layout .activity_main) 
[3 NS java (generated 
a } 
5 » or Gradle Scripts 
§ 
三 
8 
3 
8 
主 
Build: Build Output Sync 人 字 一 
千 x » Build: completed successfully at 2019-11-12 22:( 1s 60 
时 
号 w Run build /Users/guolin/AndroidStudioprojects/AndroidFirstLine/HelloWo' 
瑟 听 v Load build 
避 v Configure build 四 
9 
六 wv Calculate task graph 3 
A vv Run tasks 8 
与 1 
a B 
日 m 
间 
内 a 
: 
渤 TODO ”局 DB Execution Console 国 Terminal 80 = 6:Logcat Event Log 
Gradle build finished in1s 742 ms (3 minutes ago) 134 LF: UTF-8; 4spaces: 全 得 


图 1.11 项 目 创建 成 功 


1.3.2 ”启动 模拟 器 


由 于 Android Studio 自 动 为 我 们 生成 了 很 多 东西 ， 因 而 你 现在 不 需要 编写 任何 代码 ， 
HelloWorld 项 目 就 已 经 可 以 运行 了 。 但 是 在 此 之 前 ， 还 必须 有 一 个 运行 的 载体 ， 可 以 是 一 部 
Android 手 机 ,也 可 以 是 Android 模 拟 器 。 这 里 我 们 暂时 先 使 用 模拟 器 来 运行 程序 ， 如果 你 想 立 
刻 就 将 程序 运行 到 手机 上 的 话 ， 可 以 参考 9.1 节 的 内 容 。 


那么 我 们 现在 就 来 创建 一 个 Android 模 拟 器 ， 观 察 Android Studio 顶 部 工具 栏 中 的 图 标 ， 如 图 
1.12 所 示 。 


起 世 醒 


图 1.12 顶部 工具 栏 中 的 图 标 
中 间 的 按钮 就 是 用 于 创建 和 局 动 模拟 器 的 ， 点 击 该 按钮 ， 会 弹出 如 图 1.13 所 示 的 窗口。 


www.blogss.cn 


© Android Virtual Device Manager 


Your Virtual Devices 


ODLj 同 国 


Virtual devices allow you to test your application without 
having to own the physical devices. 


人 Android Studio 


Create Virtual Device 


To prioritize which devices to test your application on, 
Visit the Android Dashboards, where you can get 
up-to-date information on which devices are active in the 
Android and Google Play ecosystem. 


图 1.13 创建 模拟 器 


可 以 看 到 ， 目 前 我 们 的 模拟 器 列表 中 还 是 空 的 ， 点击“Create Virtual Device” 按 钮 就 可 以 立刻 


开始 创建 了 ， 如 图 1.14 所 示 。 


Virtual Device Configuration 


Select Hardware 


人 Android Studio 


Choose a device definition 
= = [DH Pixel 
Name ~ Play Store Size Resolution Density 
Pixel XL 5.5” 1440x2... 560dpi 
Pixel 3a XL 6.0" 1080x2... 400dpi ee 
Size large 
Dy Ratio long 
Pixel 3a B 5.6 1080x2... 440dpi Density: 420dpi 
9 
Tablet Pixel 3 XL 6.3° 1440x2... 560dpi 六 
Pixel 3 BE 5.46" 1080x2... 440dpi 
Pixel 2 XL 5.99" 1440x2... ”560dpi 
Pixel 2 BP 5.0" 1080x1... 420dpi 
Nexus S 4.0" 480x800 hdpi 
New Hardware Profile Import Hardware Profiles Ss Clone Device... 
? Cancel Pr 4 Next 


图 1.14 ”选择 要 创建 的 模拟 器 设备 


这 里 有 很 多 种 设备 可 供 我 们 选择 ， 不 仅 能 创建 手机 模拟 器 ， 还 可 以 创建 平板 、 手 表 、 电 视 等 模 


拟 妖 。 
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那么 我 就 选择 创建 Pixel 这 台 设备 的 模拟 器 了 ， 这 是 我 个 人 非常 钟爱 的 一 台 设备 。 点 击 “Next”， 
如 图 1.15 所 示 。 


Virtual Device Configuration 


System Image 
Android Studio 


Select a System image 


Recommended x86Images Otherlmages 


Release Name APILevel vw | ABI Target 


Q Download 29 x86 Android 10.0 (Google Play) 
Apl Level 


Pie Download 28 x86 Android 9.0 (Google y 

29 
Oreo Download 2 x86 An gq81 y) 
Oreo Download 26 x86 Android 8 7 ey Android 
Nougat Download 2 x86 Android 7.1.1 (Google Play 10.0 


Google Inc. 
Nougat Download 24 x86 Android 7.0 (Google Pi nog me 


System Image 


x86 


We recommend these Google Play images because 
this device is compatible with Google Play. 


Questions on APl level? 
See the APl level distribution chart 


@ A system image must be selected to continue. 


? Cancel Previous 


图 1.15 选择 模拟 器 的 操作 系统 版 本 


这 里 可 以 选择 模拟 器 所 使 用 的 操作 系统 版 本 ， 之 无 疑问 ,我们 肯定 要 选择 最 新 的 Android 10.0 
系统 。 但 是 由 于 目前 我 的 本 机 还 不 存在 Android 10.0 系 统 的 镜像 ， 因 此 需要 先 点 
击 “Download" 下 载 镜像 。 下 载 完 成 后 继续 点 击 “Next”, 出 现 如 图 1.16 所 示 的 界面 。 


© 9 Virtual Device Configuration 


Android Virtual Device (AVD) 


Android Studio 


Verify Configuration 
AVD Name [ae | AVD Name 
[Db Pixel 5.0 1080x1920 420dpi The name of this AVD. 
全 Android 10.0 x86 
Startup orientation 品 
Portrait Landscape 
Emulated 
Performance he 


Device Frame Enable Device Frame 


Show Advanced Settings 


? Cancel Previous Next 
图 1.16 确认 模拟 器 配置 
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在 这 里 我 们 可 以 对 模拟 怖 的 一 些 配 置 进行 确认 ， 比 如 说 指定 模拟 居 的 名 字 、 分 辨 率 、 横 坚 屏 等 
信息 ,如果 没 有 特殊 需求 的 话 ， 全 部 保持 默认 就 可 以 了 。 点 击 “Finish" 完 成 模拟 器 的 创建 ， 然 后 
会 弹出 如 图 1.17 所 示 的 窗口 。 


全 全 @ Android Virtual Device Manager 


Your Virtual Devices 


/以 Android Studio 


Type Name Play Store Resolution API Target 
[0 Pixel API 29 BB- 1080 x 1920: 420... 29 Android 10.0... x86 513 MB 


CPU/AB| ^ SizeonDisk Actions 
prov 


? + Create Virtual Device... 


图 1.17 ”模拟 器 列表 


可 以 看 到 ， 现 在 模拟 器 列表 中 已 经 存在 一 个 创建 好 的 模拟 器 设备 了 ， 点 击 Actions 栏 目 中 最 左边 
的 三 角形 按钮 即 可 启动 模拟 器 。 模 拟 器 会 像 手 机 一 样 ， 有 一 个 开机 过 程 ， 启 动 完成 之 后 的 界面 


如 图 1.18 所 示 。 


Wiesdaw Nowi2 
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图 1.18 启动 后 的 模拟 器 界面 


很 清新 的 Android 界 面 出 来 了 ! 看 上 去 还 挺 不 错 吧 ， 你 几乎 可 以 像 使 用 手机 一 样 使 用 它 ， 
Android 模 拟 器 对 手机 的 模仿 度 非常 高 ， 快 去 体验 一 下 吧 。 


1.3.3 运行 HelloWorld 

现在 模拟 器 已 经 启动 起 来 了 ， 那 么 下 面 我 们 就 将 HelloWorld 项 目 运 行 到 模拟 器 上 。 观 察 
Android Studio 顶 部 工具 栏 中 的 图 标 ， 如 图 1.19 所 示 ， 其 中 左边 的 锤子 按钮 是 用 来 编译 项 目 
的 。 中 和 间 有 两 个 下 拉 列 表 : 一 个 是 用 来 选择 运行 哪 一 个 项 目的 ， 通常 app 就 是 当前 的 主 项 目 ; 另 
一 个 是 用 来 选择 运行 到 哪 台 设 备 上 的 ， 可 以 看 到 ， 我 们 刚刚 创建 的 模拟 怖 现在 已 经 在 线 了 。 碳 
边 的 三 角形 按钮 是 用 来 运行 项 目的 。 


A | 下 app v LPixel AP129 了 | BP 


图 1.19 ”顶部 工具 栏 中 的 图 标 


现在 点 击 右边 的 运行 按钮 ， 稍微 等 竺 一会儿, HelloWorld 项 目 就 会 运行 到 模拟 器 上 了 ， 结 果 应 
该 和 图 1.20 中 显示 的 是 一 样 的 。 
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10:32 a | 


HelloWorld 


图 1.20 运行 HelloWorld 项 目 


HelloWorld 项 目 运行 成 功 ! 并 且 你 会 发 现 ， 模 拟 器 上 已 经 安装 HelloWorld 这 个 应 用 了 。 打 开启 
动 器 列表 ,如 图 1.21 所 示 。 
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图 1.21 查看 启动 器 列表 

这 个 时 候 你 可 能 会 说 我 坑 你 了 ， 说 好 的 第 一 行 代码 呢 ? 怎么 一 行 还 没 写 ， 项 目 就 已 经 运行 起 来 
了 ?这 个 只 能 说 是 因为 Android Studio 太 智能 了 ， 已 经 帮 我 们 把 一 些 简单 的 内 容 自 动 生成 了 。 
你 也 别 心 急 , 后面 写 代码 的 机 会 多 着 呢 ,我们 先 来 分 析 一 下 HelloWorld 这 个 项 目 吧 。 


1.3.4 分 析 你 的 第 一 个 Android 程 序 
回 到 Android Studio 中 ， 首 先 展开 HelloWorld 项 目 ， 你 会 看 到 如 图 1.22 所 示 的 项 目 结构 。 
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»|4 
分 
| 


局 Android v 全 
“app 
WW manifests 
Ml java 
时 java (generated) 
res 
sres (generated) 
A Cradle Scripts 
build.gradle (Project: HelloWorld) 
build.gradle (Module: app) 
"i gradle-wrapper.properties (Gradle Version) 
a proguard-rules.pro (ProGuard Rules for app) 
中 gradle.properties (Project Properties) 
settings.gradle (Project Settings) 
中 local.properties (SDK Location) 


UD 


图 1.22 Android 模 式 的 项 目 结构 


任何 一 个 新 建 的 项 目 都 会 默认 使 用 Android 模 式 的 项 目 结构 , 但 这 并 不 是 项 目 真 实 的 目录 结构 ， 
而 是 被 Android Studio 转 换 过 的 。 这 种 项 目 结 构 简 洁 明 了 ， 适合 进 行 快速 开发 ， 但 是 对 于 新 手 
来 说 可 能 不 易于 理解 。 点 击 图 1.22 中 最 上 方 的 Android 区 域 可 以 切换 项 目 结构 模式 ， 如 图 1.23 
所 示 。 


需 Android = 
Packages 
Project Files 
六 Production 
4 Tests 
MH Project Source Files 
Project Non-Source Files 
A Problems 
顺 Android 


图 1.23 切换 项 目 结构 模式 
这 里 我 们 将 项 目 结构 模式 切换 成 Project， 这 就 是 项 目 真实 的 目录 结构 了 ， 如 图 1.24 所 示 。 
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司 Project ~ © 
至 HelloWorld 
Ml .gradle 
.idea 
sapp 
Ml build 
gradle 
.gitignore 
build.gradle 
“| gradle.properties 
下 gradlew 
引 gradlew.bat 
于 HelloWorld.iml 
"ilocal.properties 
settings.gradle 
lll External Libraries 
®@ Scratches and Consoles 


中 4 
女 
| 


图 1.24 Project 模 式 的 项 目 结构 


一 开始 看 到 这 么 多 陌生 的 东西 ， 你 一 定 会 有 点 头晕 吧 。 别 担心 ， 我 现在 就 对 图 1.24 中 的 内 容 进 
行 讲 解 ， 之 后 你 再 看 这 张 图 就 不 会 感到 那么 吃力 了 。 


01. 


02. 


03. 


04. 


05. 


.gradle 和 .idea 


这 两 个 目录 下 放置 的 都 是 Android Studio 自 动 生 成 的 一 些 文件 ， 我 们 无 须 关 心 ， 也 不 要 去 
手动 编辑 。 


app 


项 目 中 的 代码 、 资 源 等 内 容 都 是 放置 在 这 个 目录 下 的 ， 我 们 后 面 的 开发 工作 也 基本 是 在 这 
个 目录 下 进行 的 ， 待 会 儿 还 会 对 这 个 目录 单独 展开 讲解 。 


build 
这 个 目录 主要 包含 了 一 些 在 编译 时 自动 生成 的 文件 ， 你 也 不 需要 过 多 关心 。 
gradle 


这 个 目录 下 包含 了 gradle wrapper 的 配置 文件 ， 使 用 gradle wrapper 的 方式 不 需要 提前 
将 gradle 下 载 好 ,而 是 会 自动 根据 本 地 的 缓存 情况 决定 是 否 需要 联网 下 载 gradle。 
Android Studio 默 认 就 是 启用 gradle wrapper 方 式 的 ， 如果 需要 更 改 成 离线 模式 ， 可 以 
点 击 Android Studio 导 航 栏 ”File 一 Settings 一 Build，Execution， 
DeploymentGradle ,进行 配置 更 改 。 


.gitignore 
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06. 


07. 


08. 


09. 


10. 


11. 


这 个 文件 是 用 来 将 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 的 。 关 于 版 本 控制 ， 我 们 将 在 第 6 
章 中 开始 正式 的 学 习 。 


build.gradle 


这 是 项 目 全 局 的 gradle 构 建 脚本 ， 通 常 这 个 文件 中 的 内 容 是 不 需要 修改 的 。 稍 后 我 们 将 会 
详细 分 析 gradle 构 建 脚本 中 的 具体 内 容 。 


gradle.properties 


这 个 文件 是 全 局 的 gradle 配 置 文件 ， 在 这 里 配置 的 属性 将 会 影响 到 项 目 中 所 有 的 gradle 编 
译 脚本 。 


gradlew 和 gradlew.bat 


这 两 个 文件 是 用 来 在 命令 行 界面 中 执行 gradle 命 令 的 ,其 中 gradlew 是 在 Linux 或 Mac 系 统 
中 使 用 的 ，gradlew.bat 是 在 Windows 系 统 中 使 用 的 。 


HelloWorld.iml 


im| 文 件 是 所 有 Intellij IDEA 项 目 都 会 自动 生成 的 一 个 文件 (Android Studio 是 基于 Intelli 
IDEA 开 发 的 ) ， 用 于 标识 这 是 一 个 Intellij IDEA 项 目 ，, 我 们 不 需要 修改 这 个 文件 中 的 任何 
内 容 。 


local.properties 


这 个 文件 用 于 指定 本 机 中 的 Android SDK 路 径 ， 通常 内 容 是 自动 生成 的 ， 我们 并 不 需要 修 
改 。 除 非 你 本 机 中 的 Android SDK 位 置 发 生 了 变化 ,那么 就 将 这 个 文件 中 的 路 径 改 成 新 的 
位 置 即 可 。 


settings.gradle 


这 个 文件 用 于 指定 项 目 中 所 有 引入 的 模块 。 由 于 HelloWorld 项 目 中 只 有 一 个 app 模 块 ， 
此 该 文件 中 也 就 只 引入 了 app 这 一 个 模块 。 通 常情 况 下 ， 模 块 的 引入 是 自动 完成 的 ， 需 要 我 
们 手动 修改 这 个 文件 的 场景 可 能 比较 少 。 


现在 整个 项 目的 外 层 目录 结构 已 经 介绍 完了 。 你 会 发 现 ， 除 了 app 目 录 之 外 ， 大 多 数 的 文件 和 目 
录 是 自动 生成 的 ， 我 们 并 不 需要 进行 修改 。 想 必 你 已 经 猿 到 了 ，app 目 录 下 的 内 容 才 是 我 们 以 后 
的 工作 重点 ， 展 开 之 后 的 结构 如 图 1.25 所 示 。 
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s app 
MM build 
libs 
src 
androidTest 
main 
MM java 
res 
je ANdroidManifest.xml 
test 
引 .gitignore 
s app.iml 
build.gradle 
兰 proguard-rules.pro 


图 1.25 app 目 录 下 的 结构 
那么 下 面 我 们 就 来 对 app 目 录 下 的 内 容 进行 更 为 详细 的 分 析 。 


01. 


02. 


03. 


04. 


05. 


06. 


build 


这 个 目录 和 外 层 的 build 目 录 类 似 ， 也 包含 了 一 些 在 编译 时 自动 生成 的 文件 ， 不 过 它 里 面 的 
内 容 会 更 加 复杂 ,我们 不 需要 过 多 关心 。 


libs 


如 果 你 的 项 目 中 使 用 到 了 第 三 方 jar 包 ， 就 需要 把 这 些 jar 包 都 放 在 libs 目 录 下 ， 放 在 这 个 目 
录 下 的 jar 包 会 被 自动 添加 到 项 目的 构建 路 径 里 。 


androidTest 
此 处 是 用 来 编写 Android Test 测 试用 例 的 ， 可 以 对 项 目 进行 一 些 自动 化 测试 。 
java 


之 无 疑问 ,java 目录 是 放置 我 们 所 有 Java 代 码 的 地 方 (Kotlin 代 码 也 放 在 这 里 ) ， 展 开 该 
目录 ， 你 将 看 到 系统 帮 有 我 们 自动 生成 了 一 个 MainActivity 文 件 。 


res 


这 个 目录 下 的 内 容 就 有 点 多 了 。 简 单 点 说 ， 就 是 你 在 项 目 中 使 用 到 的 所 有 图 片 、 布 局 、 字 
符 串 等 资源 都 要 存放 在 这 个 目录 下 。 当 然 这 个 目录 下 还 有 很 多 子 目录 , 图片 放 在 drawable 
目录 下 ， 布局 放 在 layout 目 录 下 ， 字符 串 放 在 values 目 录 下 ， 所 以 你 不 用 担心 会 把 整个 res 
目录 弄 得 乱糟糟 的 。 


AndroidManifest.xml 


这 是 整个 Android 项 目的 配置 文件 ， 你 在 程序 中 定义 的 所 有 四 大 组 件 都 需要 在 这 个 文件 里 注 
册 ， 另 外 还 可 以 在 这 个 文件 中 给 应 用 程序 添加 权限 声明 。 由 于 这 个 文件 以 后 会 经 常用 到 ， 
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我 们 等 用 到 的 时 候 再 做 详细 说 明 。 
07. test 

此 处 是 用 来 编写 Unit Test 测 试用 例 的 ， 是 对 项 目 进行 自动 化 测试 的 另 一 种 方式 。 
08. .gitignore 


这 个 文件 用 于 将 app 模 块 内 指定 的 目录 或 文件 排除 在 版 本 控制 之 外 ， 作用 和 外 层 
的 .gitignore 文 件 类 似 。 


09. app.iml 
Intellij IDEA 项 目 自动 生成 的 文件 ， 我 们 不 需要 关心 或 修改 这 个 文件 中 的 内 容 。 
10. build.gradle 


这 是 app 模 块 的 gradle 构 建 脚本 ， 这 个 文件 中 会 指定 很 多 项 目 构建 相关 的 配置 ， 我 们 稍 后 
将 会 详细 分 析 gradle 构 建 脚本 中 的 具体 内 容 。 


11. proguard-rules.pro 
这 个 文件 用 于 指定 项 目 代 码 的 混淆 规则 ,当代 码 开发 完成 后 打包 成 安装 包 文件 ， 如果 不 希 
望 代码 被 别人 破解 ， 通 常会 将 代码 进行 混淆 ， 从 而 让 破解 者 难以 阅读 。 


这 样 整个 项 目的 目录 结构 就 都 介绍 完了 ， 如 果 你 还 不 能 完全 理解 的 话 也 很 正常 ， 毕 竟 里 面 有 太 
多 的 东西 你 都 还 没 接触 过 。 不 过 不 用 担心 ， 这 并 不 会 影响 你 后 面 的 学 习 。 等 你 学 完整 本 书 再 回 
来 看 这 个 目录 结构 图 时 ， 你 会 觉得 特别 地 清晰 和 简单 。 


接 下 来 我 们 一 起 分 析 一 下 HelloWorld 项 目 究竟 是 怎么 运行 起 来 的 吧 。 首 先 打开 Android- 
Manifest.xm| 文 件 ， 从 中 可 以 找到 如 下 代码 : 


<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


这 段 代码 表示 对 MainActivity 进 行 注册 , 没有 在 AndroidManifest.xml 里 注册 的 Activity 是 不 
能 使 用 的 。 其 中 intent -fiLter 里 的 两 行 代码 非常 重要 ,<action 
android:name="android.intent.action.MAIN"/> 和 <category 
android:name="android.intent.category .LAUNCHER"” /> 表示 MainActivity 是 这 个 
项 目的 主 Activity， 在 手机 上 点 击 应 用 图 标 ， 首 先 启动 的 就 是 这 个 Activity。 


那 MainActivity 具 体 又 有 什么 作用 呢 ? 我 在 介绍 Android 四 大 组 件 的 时 候 说 过 ，Activity 是 
Android 应 用 程序 的 门面 ,凡是 在 应 用 中 你 看 得 到 的 东西 ， 都 是 放 在 Activity 中 的 。 因 此 你 在 图 
1.20 中 看 到 的 界面 ， 其 实 就 是 MainActivity。 那 我 们 快 去 看 一 下 它 的 代码 吧 ,打开 
MainActivity ,代码 如 下 所 示 : 
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class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


} 
| 


首先 可 以 看 到 ，MainActivity 是 继承 自 AppCompatActivity 的 。AppCompatActivity 是 
AndroidX 中 提供 的 一 种 向 下 兼容 的 Activity， 可 以 使 Activity 在 不 同系 统 版 本 中 的 功能 保持 一 
致 性 。 而 Activity 类 是 Android 系 统 提 供 的 一 个 基 类 ， 我 们 项 目 中 所 有 自 定义 的 Activity 都 必须 
继承 它 或 者 它 的 子 类 才能 拥有 Activity 的 特性 (AppCompatActivity 是 Activity 的 子 类 ) 。 然 
后 可 以 看 到 MainActivity 中 有 一 个 onCreate () 方 法 ,这 个 方法 是 一 个 Activity 被 创建 时 必定 要 
执行 的 方法 ， 其 中 只 有 两 行 代码 ， 并 且 没有 “Hello World! “的 字样 。 那 么 图 1.20 中 显示 

的 “Hello World! "是 在 哪里 定义 的 呢 ? 


其 实 Android 程 序 的 设计 讲究 逻辑 和 视图 分 离 ， 因 此 是 不 推荐 在 Activity 中 直接 编写 界面 的 。 一 
种 更 加 通用 的 做 法 是 ， 在 布局 文件 中 编写 界面 ， 然 后 在 Activity 中 引入 进来 。 可 以 看 到 ， 在 
onCreate( ) 方 法 的 第 二 行 调 用 了 setContentView( ) 方 法 ， 就 是 这 个 方法 给 当前 的 Activity 
引入 了 一 个 activity_main 布 局 ， 那 “Hello World!” 一 定 就 是 在 这 里 定义 的 了 ! 我 们 快 打开 这 个 
文件 看 一 看 。 


布局 文件 都 是 定义 在 res/layout 目 录 下 的 ， 当 你 展开 layout 目 录 ， 你 会 看 到 
activity_main.xml 这 个 文件 。 打 开 该 文件 并 切换 到 Text 视 图 ,代码 如 下 所 示 : 


<androidx.constraintlayout.widget.ConstraintLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
tools:context=" .MainActivity"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:text="Hello World!" 
app:layout constraintBottom toBottom0f="parent" 
app:layout constraintLeft toLeft0f="parent" 
app:Layout constraintRight toRight0f="parent" 
app:layout constraintTop toTopO0f="parent" /> 


</androidx.constraintlayout.widget.ConstraintLayout> 


现在 还 看 不 懂 ? 没关系， 后 面 我 会 对 布局 进行 详细 讲解 ， 你 现在 只 需要 看 到 上 面 代 码 中 有 一 个 
TextView， 这 是 Android 系 统 提供 的 一 个 控件 ， 用 于 在 布局 中 显示 文字 。 然 后 你 终于 在 
TextView 中 看 到 了 “Hello World ! “的 字样 ! 哈哈 ! 终于 找到 了 ， 原 来 就 是 通过 
android:text="Hello World!" 这 名 代码 定义 的 。 


这 样 我 们 就 将 HelloWorld 项 目的 目录 结构 以 及 基本 的 执行 过 程 分 析 完 了 ， 相 信 你 对 Android 项 
目 已 经 有 了 一 个 初步 的 认识 ， 下 一 小 节 中 我 们 就 来 学 习 一 下 项 目 中 所 包含 的 资源 。 
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1.3.5 详解 项 目 中 的 资源 


如 果 你 展开 res 目 录 看 一 下 ， 其实 里 面 的 东西 还 是 挺 多 的 ， 很 容易 让 人 看 得 眼花 综 乱 ， 如 图 1.26 
所 未。 


drawable 
drawable-v24 
layout 
mipmap-anydpi-v26 
mipmap-hdpi 
mipmap-mdpi 
mipmap-xhdpi 
mipmap-xxhdpi 
mipmap-xxxhdpi 
values 


图 1.26 res 目录 下 的 结构 


看 到 这 么 多 的 子 目 录 也 不 用 害怕 ， 其实 归纳 一 下 ，res 目 录 中 的 内 容 就 变 得 非常 简单 了 。 所 有 
以 “drawable" 开 头 的 目录 都 是 用 来 放 图 片 的 , 所 有 以 “mipmap" 开 头 的 目录 都 是 用 来 放 应 用 图 
标的 ,所 有 以 “values” 开 头 的 目录 都 是 用 来 放 字 符 串 、 样 式 、 颜 色 等 配置 的 ,所 有 

以 “layout" 开 头 的 目录 都 是 用 来 放 布 局 文件 的 。 怎 么 样 ， 是 不 是 突然 感觉 清晰 了 很 多 ? 


之 所 以 有 这 么 多 “mipmap” 开 头 的 目录 ,其实 主 要 是 为 了 让 程序 能 够 更 好 地 兼容 各 种 设备 。 
drawable 目 录 也 是 相同 的 道理 ， 虽 然 Android Studio 没 有 帮 有 我 们 自动 生成 ， 但 是 我 们 应 该 自 
己 创建 drawable-hdpi、drawable-xhdpi、drawable-xxhdpi 等 目录 。 在 制作 程序 的 时 候 ， 
最 好 能 够 给 同一 张 图 片 提 供 几 个 不 同 分 辨 率 的 版 本 ， 分 别 放 在 这 些 目录 下 ， 然 后 程序 运行 的 时 
候 ,会 自动 根据 当前 运行 设备 分 辩 率 的 高 低 选 择 加 载 哪个 目录 下 的 图 片 。 当 然 这 只 是 理想 情 
况 ， 更 多 的 时 候 美 工 只 会 提供 给 我 们 一 份 图 片 ， 这 时 你 把 所 有 图 片 都 放 在 drawable-xxhdpi 目 
录 下 就 好 了 ， 因 为 这 是 最 主流 的 设备 分 辩 率 目录 。 


知道 了 res 目 录 下 每 个 子 目 录 的 含义 ， 我 们 再 来 看 一 下 如 何 使 用 这 些 资源 吧 。 打 开 
res/values/strings.xmI| 文 件 ， 内容 如 下 所 示 : 


<resources> 
<string name="app_ name">HelloWorld</string> 
</resources> 


可 以 看 到 ， 这 里 定义 了 一 个 应 用 程序 名 的 字符 串 ， 我 们 有 以 下 两 种 方式 来 引用 它 。 


。 在 代码 中 通过 R.string.app_name 可 以 获得 该 字符 串 的 引用 。 

。 在 XML 中 通过 @string/app_name 可 以 获得 该 字符 串 的 引用 。 
基本 的 语法 就 是 上 面 这 两 种 方式 ， 其 中 string 部 分 是 可 以 替换 的 ,如果 是 引用 的 图 片 资 源 就 可 
以 蔡 换 成 drawable ,如果 是 引用 的 应 用 图 标 就 可 以 替换 成 mipmap， 如 果 是 引用 的 布局 文件 就 
可 以 替换 成 Layout ,以 此 类 推 。 
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下 面 举 一 个 简单 的 例子 来 帮助 你 理解 ， 打 开 AndroidManifest.xm| 文 件 ,找到 如 下 代码 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


其 中 , HelloWorld 项 目的 应 用 图 标 就 是 通过 android:icon 属 性 指定 的 , 应 用 的 名 称 则 是 通过 
android:LabetL 属 性 指定 的 。 可 以 看 到 ， 这 里 对 资源 引用 的 方式 正 是 我 们 刚刚 学 过 的 在 XML 中 
引用 资源 的 语法 。 


经 过 本 小 节 的 学 习 ， 如 果 你 想 修改 应 用 的 图 标 或 者 名 称 ， 相 信 已 经 知道 该 怎么 办 了 吧 。 
1.3.6 详解 build.gradle 文 件 


不 同 于 Eclipse , Android Studio 是 采用 Gradle 来 构建 项 目的 。Gradle 是 一 个 非常 先进 的 项 目 
构建 工具 ， 它 使 用 了 一 种 基于 Groovy 的 领域 特定 语言 (DSL) 来 进行 项 目 设置 ， 握 弃 了 传统 基 
于 XML (如 Ant 和 Maven) 的 各 种 烦琐 配置 。 


在 1.3.4 小 节 中 我 们 已 经 看 到 ，HelloWorld 项 目 中 有 两 个 build.gradle 文 件 ， 一 个 是 在 最 外 层 目 
录 下 的 ,一 个 是 在 app 目 录 下 的 。 这 两 个 文件 对 构建 Android Studio 项 目 都 起 到 了 至 关 重 要 的 
作用 ,下面 我 们 就 来 对 这 两 个 文件 中 的 内 容 进 行 详细 的 分 析 。 


先 来 看 一 下 最 外 层 目 录 下 的 build.gradle 文 件 ， 代 码 如 下 所 示 : 


buildscript { 
ext.kotlin version = '1.3.61' 
repositories { 
google() 
jcenter() 


dependencies { 
classpath 'com.android.tools.build:gradle:3.5.2" 
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin version" 


} 


allprojects { 
repositories { 
google() 
jcenter() 


} 


这 些 代码 都 是 自动 生成 的 ， 虽然 语法 结构 看 上 去 可 能 有 点 难以 理解 ， 但 是 如 果 我 们 忽略 语法 结 
构 ， 只 看 最 关键 的 部 分 ， 其 实 还 是 很 好 懂 的 。 


首先 ， 两 处 repositories 的 闭 包 中 都 声明 了 google() 和 jcenter() 这 两 行 配 置 ， 那么 它们 
是 什么 意思 呢 ? 其 实 它们 分 别 对 应 了 一 个 代码 仓库 ,， google 仓库 中 包含 的 主要 是 Google 自 家 的 
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扩展 依赖 库 ， 而 jcenter 仓 库 中 包含 的 大 多 是 一 些 第 三 方 的 开源 库 。 声 明了 这 两 行 配置 之 后 ,我 
们 就 可 以 在 项 目 中 轻松 引用 任何 google 和 jcenter 仓 库 中 的 依赖 库 了 。 


接 下 来 ，dependencies 闭 包 中 使 用 classpath 声 明了 两 个 插件 : 一 个 Gradle 插 件 和 一 个 
Kotlin 插 件 。 为 什么 要 声明 Gradle 插 件 呢 ? 因为 Gradle 并 不 是 专门 为 构建 Android 项 目 而 开发 
的 ,java、C++ 等 很 多 种 项 目 也 可 以 使 用 Gradle 来 构建 ， 因 此 如 果 我 们 要 想 使 用 它 来 构建 
Android 项 目 ， 则 需要 声明 com.android.tools.build:gradle:3.5.2 这 个 插件 。 其 中 ,最 后 面 
的 部 分 是 插件 的 版 本 号 , 它 通常 和 当前 Android Studio 的 版 本 是 对 应 的 ， 比 如 我 现在 使 用 的 是 
Android Studio 3.5.2 版 本 ， 那 么 这 里 的 插件 版 本 号 就 应 该 是 3.5.2。 而 另外 一 个 Kotlin 插 件 则 
表示 当前 项 目 是 使 用 Kotlin 进 行 开 发 的 ， 如果 是 Java 版 的 Android 项 目 ， 则 不 需要 声明 这 个 插 
件 。 我 在 编写 本 书 时 ，Kotlin 插 件 的 最 新 版 本 号 是 1.3.61。 


这 样 我 们 就 将 最 外 层 目录 下 的 build.gradle 文 件 分 析 完 了 ， 通常 情况 下 ， 你 并 不 需要 修改 这 个 
文件 中 的 内 容 ， 除 非 你 想 添加 一 些 全 局 的 项 目 构建 配置 。 


下 面 我 们 再 来 看 一 下 app 目 录 下 的 build.gradle 文 件 ,代码 如 下 所 示 : 


apply plugin: 'com.android.application' 
apply plugin: 'kotlin-android' 
apply plugin: 'kotlin-android-extensions' 


android { 

compileSdkVersion 29 

buildToolsVersion "29.0.2" 

defaultConfig { 
appLicationId "com.example.helloworld" 
minSdkVersion 21 
targetSdkVersion 29 
versionCode 1 
versionName "1.0" 
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" 


} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 
'proguard-rules.pro’ 


} 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 
implementation 'androidx.appcompat:appcompat:1.1.0" 
implementation 'androidx.core:core-ktx:1.1.0" 
implementation 'androidx.constraintlayout:constraintlayout:1.1.3" 
testImpLementation 'junit:junit:4.12'" 
androidTestImpLementation 'androidx.test.ext:junit:1.1.1" 
androidTestImpLementation 'androidx.test.espresso:espresso-core:3.2.0" 


} 


这 个 文件 中 的 内 容 就 要 相对 复杂 一 些 了 ， 下面 我 们 一 行 行 地 进行 分 析 。 首 先 第 一 行 应 用 了 一 个 
插件 ， 一 般 有 两 种 值 可 选 : com .android.application 表 示 这 是 一 个 应 用 程序 模块 ， 
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com.android.1library 表 示 这 是 一 个 库 模块 。 二 者 最 大 的 区 别 在 于 ， 应 用 程序 模块 是 可 以 直 
接 运行 的 ， 库 模块 只 能 作为 代码 库 依附 于 别 的 应 用 程序 模块 来 运行 。 


接 下 来 的 两 行 应 用 了 kotlin-android 和 kotlin-android-extensions 这 两 个 插件 。 如 果 你 想 要 使 
用 Kotlin 来 开发 Android 项 目 ， 那 么 第 一 个 插件 就 是 必须 应 用 的 。 而 第 二 个 插件 帮助 我 们 实现 了 
一 些 非常 好 用 的 Kotlin 扩 展 功 能 ， 在 后 面 的 章节 中 ,你 将 能 体会 到 它 所 带 来 的 巨大 便利 性 。 


紧 接 着 是 一 个 大 的 android 闭 包 , 在 这 个 闭 包 中 我 们 可 以 配置 项 目 构建 的 各 种 属性 。 其 中 ， 
compileSdkVersion 用 于 指定 项 目的 编译 版 本 ， 这 里 指定 成 29 表 示 使 用 Android 10.0 系 统 的 
SDK 编 译 。buildToolsVersion 用 于 指定 项 目 构建 工具 的 版 本 ， 目 前 最 新 的 版 本 就 是 
29.0.2， 如 果 有 更 新 的 版 本 时 , Android Studio 会 进行 提示 。 


然后 我 们 看 到 , and roid 闭 包 中 又 和 能 套 了 一 个 defauLtConfig 闭 包 , defaultConfig 闭 包 中 
可 以 对 项 目的 更 多 细节 进行 配置 。 其 中 , appLicationId 是 每 一 个 应 用 的 唯一 标识 符 ， 绝 对 不 
能 重复 ， 默认 会 使 用 我 们 在 创建 项 目 时 指定 的 包 名 ， 如果 你 想 在 后 面 对 其 进行 修改 ， 那 么 就 是 
在 这 里 修改 的 。minSdkVersion 用 于 指定 项 目 最 低 兼 容 的 Android 系 统 版 本 ， 这 里 指定 成 21 
表示 最 低 兼 容 到 Android 5.0 系 统 。targetSdkVersion 指 定 的 值 表示 你 在 该 目标 版 本 上 已 经 
做 过 了 充分 的 测试 ， 系 统 将 会 为 你 的 应 用 程序 启用 一 些 最 新 的 功能 和 特性 。 比 如 Android 6.0 系 
统 中 引入 了 运行 时 权限 这 个 功能 ,如果 你 将 targetSdkVersion 指 定 成 23 或 者 更 高 ， 那么 系统 
就 会 为 你 的 程序 局 用 运行 时 权限 功能 ， 而 如 果 你 将 targetSdkVersion 指 定 成 22， 那么 就 说 明 
你 的 程序 最 高 只 在 Android 5.1 系 统 上 做 过 充分 的 测试 ，Android 6.0 系 统 中 引入 的 新 功能 自然 
就 不 会 局 用 了 。 接 下 来 的 两 个 属性 都 比较 简单 ，versionCode 用 于 指定 项 目的 版 本 号 ， 
versionName 用 于 指定 项 目的 版 本 名 。 最 后 ,testInstrumentationRunner 用 于 在 当前 项 
目 中 启用 JUnit 测 试 ， 你 可 以 为 当前 项 目 编写 测试 用 例 ， 以 保证 功能 的 正确 性 和 稳定 性 。 


分 析 完 了 defaultConfig 闭 包 ，, 接 下 来 我 们 看 一 下 buildTypes 闭 包 。buildTypes 闭 包 中 用 
于 指定 生成 安装 文件 的 相关 配置 ,通常 只 会 有 两 个 子 闭 包 : 一 个 是 debug , 一 个 是 release。 
debug 闭 包 用 于 指定 生成 测试 版 安装 文件 的 配置 ，reLease 闭 包 用 于 指定 生成 正式 版 安装 文件 
的 配置 。 另 外 , debug 闭 包 是 可 以 忽略 不 写 的 ， 因 此 我 们 看 到 上 面 的 代码 中 就 只 有 一 个 
release 闭 包 。 下 面 来 看 一 下 release 闭 包 中 的 具体 内 容 吧 ,minifyEnabled 用 于 指定 是 否 
对 项 目的 代码 进行 混淆 ，t rue 表 示 泥 淆 ，false 表 示 不 混淆 。proguardFiles 用 于 指定 混淆 
时 使 用 的 规则 文件 ， 这 里 指定 了 两 个 文件 : 第 一 个 proguard-android-optimize.txt 是 在 
<Android SDK>/tools/proguard 目 录 下 的 ， 里面 是 所 有 项 目 通 用 的 混淆 规则 ; 第 二 个 
proguard- rules .pro 是 在 当前 项 目的 根 目 录 下 的 ， 里 面 可 以 编写 当前 项 目 特有 的 混淆 规则 。 
需要 注意 的 是 , 通过 Android Studio 直 接 运 行 项 目 生 成 的 都 是 测试 版 安装 文件 ， 关 于 如 何 生成 
正式 版 安装 文件 ， 我 们 将 会 在 第 15 章 中 学 习 。 


这 样 整个 android 闭 包 中 的 内 容 就 都 分 析 完了 ， 接 下 来 还 剩 一 个 dependencies 闭 包 。 这 个 闭 
包 的 功能 非常 强大 ，, 它 可 以 指定 当前 项 目 所 有 的 依赖 关系 。 通 常 Android Studio 项 目 一 共有 3 
种 依赖 方式 : 本 地 依赖 、 库 依赖 和 远程 依赖 。 本 地 依赖 可 以 对 本 地 的 jar 包 或 目录 添加 依赖 关 
系 ， 库 依赖 可 以 对 项 目 中 的 库 模块 添加 依赖 关系 ， 远 程 依 赖 则 可 以 对 jcenter 仓 库 上 的 开源 项 目 
添加 依赖 关系 。 


观察 一 下 dependencies 闭 包 中 的 配置 ,第 一 行 的 jmplementation fileTree 就 是 一 个 本 
地 依赖 声明 , 它 表示 将 libs 目 录 下 所 有 .jar 后 缀 的 文件 都 添加 到 项 目的 构建 路 径 中 。 而 
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impLementation 则 是 远程 依赖 声明 , androidx.appcompat:appcompat:1,1,0 就 是 一 个 
标准 的 远程 依赖 库 格 式 ， 其 中 androidx.appcompat 是 域名 部 分 ， 用 于 和 其 他 公司 的 库 做 区 
分 ; appcompat 是 工程 名 部 分 ， 用 于 和 同一 个 公司 中 不 同 的 库 工程 做 区 分 ; 1.1.0 是 版 本 号 ， 
用 于 和 同一 个 库 不 同 的 版 本 做 区 分 。 加 上 这 名 声明 后 ,Gradle 在 构建 项 目 时 会 首先 检查 一 下 本 
地 是 否 已 经 有 这 个 库 的 缓存 ,如果 没有 的 话 则 会 自动 联网 下 载 ， 然后 再 添加 到 项 目的 构建 路 径 
中 。 至 于 库 依赖 声明 这 里 没有 用 到 ，, 它 的 基本 格式 是 jmplementation project 后 面 加 上 要 
依赖 的 库 的 名 称 ， 比 如 有 一 个 库 模 块 的 名 字 叫 helper ,那么 添加 这 个 库 的 依赖 关系 只 需要 加 入 
impLementation project(':helper') 这 名声 明 即 可 。 关 于 这 部 分 内 容 ,我们 将 在 本 书 的 
最 后 一 章 学 习 。 另 外 剩 下 的 testImpLementation 和 androidTestImpLementation 都 是 用 
于 声明 测试 用 例 库 的 ， 这 个 我 们 暂时 用 不 到 ， 先 名 略 它 就 可 以 了 。 
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1.4 前 行 必 备 : 掌握 日 志 工 具 的 使 用 


通过 上 一 节 的 学 习 ， 你 已 经 成 功 创建 了 你 的 第 一 个 Android 程 序 , 并 且 对 Android 项 目的 目录 结 
构 和 运行 流程 都 有 了 一 定 的 了 解 。 现 在 本 应 该 是 你 继续 前 行 的 时 候 ， 不 过 我 想 在 这 里 给 你 穿插 
一 点 内 容 ， 讲 解 一 下 Android 中 日 志 工 具 的 使 用 方法 ， 这 对 你 以 后 的 Android 开 发 之 旅 会 有 极 大 
的 帮助 。 


1.4.1 使 用 Android 的 日 志 工 具 Log 


Android 中 的 日 志 工 具 类 是 Log (android.utitL,Log) ， 这 个 类 中 提供 了 如 下 5 个 方法 来 供 我 
们 打印 日 志 。 


Log.Vv()。 用 于 打印 那些 最 为 琐碎 的 、 意 义 最 小 的 日 志 信息 。 对 应 级 别 verbose， 是 
Android 日 志 里 面 级 别 最 低 的 一 种 。 

Log.d()。 用 于 打印 一 些 调试 信息 ， 这些 信息 对 你 调试 程序 和 分 析 问 题 应 该 是 有 帮助 的 。 
对 应 级 别 debug , 比 verbose 高 一 级 。 

Log .i()。 用 于 打印 一 些 比 较 重 要 的 数据 ， 这些 数据 应 该 是 你 非常 想 看 到 的 、 可 以 帮 你 分 
析 用 户 行为 的 数据 。 对 应 级 别 info， 比 debug 高 一 级 。 

Log .w( )。 用 于 打印 一 些 警 告 信息 ,提示 程序 在 这 个 地 方 可 能 会 有 潜在 的 风险 ， 最 好 去 修 
复 一 下 这 些 出 现 警 告 的 地 方 。 对 应 级 别 warn , 比 info 高 一 级 。 

Log .e()。 用 于 打印 程序 中 的 错误 信息 ， 比 如 程序 进入 了 catch 语 名 中 。 当 有 错误 信息 打 
印 出 来 的 时 候 ， 一般 代表 你 的 程序 出 现 严重 问题 了 ， 必须 尽快 修复 。 对 应 级 别 error , 比 


warn 高 一 级 。 


其 实 很 简单 ， 一 共 就 5 个 方法 ， 当 然 每 个 方法 还 会 有 不 同 的 重 载 ， 但 那 对 你 来 说 肯定 不 是 什么 难 
理解 的 地 方 了 。 我 们 现在 就 在 HelloWorld 项 目 中 试 一 试 日 志 工具 好 不 好 用 吧 。 


打开 MainActivity ,在 onCreate ( ) 方 法 中 添加 一 行 打印 日 志 的 语句 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
Log.d("MainActivity", "onCreate execute") 


} 


Log.d() 方 法 中 传 入 了 两 个 参数 : 第 一 个 参数 是 tag， 一般 传 入 当前 的 类 名 就 好 ， 主 要 用 于 对 
打印 信息 进行 过 滤 ; 第 二 个 参数 是 nsg， 即 想 要 打印 的 具体 内 容 。 


现在 可 以 重新 运行 一 下 HelloWorld 这 个 项 目 了 ， 点击 顶部 工具 栏 上 的 运行 按钮 ， 或 者 使 用 快捷 
键 Shift + F10 (Mac 系 统 是 control + R) 。 等 程序 运行 完毕 , 点 击 Android Studio 底 部 工具 
栏 的 “Android Monitor”, 在 Logcat 中 就 可 以 看 到 打印 信息 了 ， 如 图 1.27 所 示 。 
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Logcat 


咕 Emulator PixelAPL29 Andn v com.example.helloworld (228- ~ Verbose 


| 言 2019-11-14 98:10:57.425 2287-2287/com.example.helloworld W/ActivityThread: handleWindowVisibility; no activity 
| 2019-11-14 88:10:57.472 2287-2287/com.example.helloworld D/MainActivity: onCreate execute 
| 和 泪 2019-11-14 088:10:57.584 2287-2354/com.example.helloworld D/EGL_emulation: eglMakeCurrent: 0xe56b95e0: ver 3 0 


图 1.27 Logcat 中 的 打印 信息 


其 中 ， 你 不 仅 可 以 看 到 打印 日 志 的 内 容 和 tag 名 ， 就 连 程序 的 包 名 、 打 印 的 时 间 以 及 应 用 程序 的 
进程 号 都 可 以 看 到 。 


当然 ，Logcat 中 不 光 会 显示 我 们 所 打印 的 日 志 ， 还 会 显示 许多 其 他 程序 打印 的 日 志 ， 因 此 在 很 
多 情况 下 还 需要 对 日 志 进 行 过 滤 ， 下 一 小 节 中 我 们 就 会 学 习 这 部 分 内 容 。 


另外 ， 不 知道 你 有 没有 注意 到 ,你 的 第 一 行 代码 已 经 在 不 知 不 觉 中 与 出 来 了 ， 我 也 总 算是 交差 
Ts 


1.4.2 为 什么 使 用 Log 而 不 使 用 println() 


我 相信 很 多 的 Java 新 手 会 非常 喜欢 使 用 System.out .println() 方 法 来 打印 日 志 , 在 Kotlin 
中 与 之 对 应 的 是 printtLn( ) 方 法 ， 不 知道 你 是 不 是 也 喜欢 这 么 做 。 不 过 在 真正 的 项 目 开发 中 ， 
是 极度 不 建议 使 用 System.out.printtn() 或 printtLn() 方 法 的 ,如 果 你 在 公司 的 项 目 中 经 
常 使 用 这 两 个 方法 来 打印 日 志 的 话 ， 就 很 有 可 能 要 挨 骂 了 。 


为 什么 System,out .printLn() 和 printtn() 方 法 会 这 么 不 受 待 见 呢 ? 经 过 我 仔细 分 析 之 
后 ， 发 现 这 两 个 方法 除了 使 用 方便 一 点 之 外 ， 其 他 就 一 无 是 处 了 。 方 便 在 哪儿 呢 ? 在 Android 
Studio 中 你 只 需要 输入 “sout”, 然后 按 下 代码 提示 键 ， 方 法 就 会 自动 出 来 了 ， 相 信 这 也 是 很 多 
Java 新手 对 它 钟情 的 原因 。 那 缺点 又 在 哪儿 了 呢 ? 这 个 就 太 多 了 ， 比 如 日 志 开关 不 可 控制 、 不 
能 添加 日 志 标 签 、 日 志 没有 级 别 区 分 .……. 


听 我 说 了 这 些 ， 你 可 能 已 经 不 太 想 用 System,out .printLn() 和 printtn() 方 法 了 ,那么 
Log 就 把 上 面 所 说 的 缺点 全 部 改 好 了 吗 ? 虽然 谈 不 上 全 部 ， 但 我 觉得 Log 已 经 做 得 相当 不 错 了 。 
我 现在 就 来 带 你 看 看 LoOg 和 Logcat 配 合 的 强大 之 处 。 


首先 ,Logcat 中 可 以 很 轻松 地 添加 过 渡 兹 ,你 可 以 在 图 1.28 中 看 到 | 我们 目前 所 有 的 过 滤 兹 。 


本 ew a I 
| Show only selected application v | 


一 


Show only selected application 
Firebase 


No Filters 
Edit Filter Configuration 


图 1.28 Logcat 中 的 过 滤器 


目前 只 有 3 个 过 滤器 ，Show only selected application 表 示 只 显示 当前 选中 程序 的 日 志 ; 
Firebase 是 Google 提 供 的 一 个 开发 者 工具 和 基础 架构 平台 ， 我 们 可 以 不 用 管 已 ; No Filters 相 
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当 于 没有 过 滤器 ， 会 把 所 有 的 日 志 都 显示 出 来 。 那 可 不 可 以 自 定 义 过 滤器 呢 ? 当然 可 以 ， 我 们 
现在 就 来 添加 一 个 过 滤器 试 试 。 

点 击 图 1.28 中 的 “Edit Filter Configuration”，, 会 弹出 一 个 过 滤器 配置 界面 。 我 们 给 过 滤器 起 
名 叫 data， 并且 让 它 对 名 为 data 的 tag 进 行 过 滤 ， 如 图 1.29 所 示 。 


©@° @ Create New Logcat Filter 
= 是 Filter Name: data 

ldata | Specify one or several filtering parameters: 
Log Tag: -data Regex 
Log Message: , Regex 
Package Name: ” Regex 
PID: 
Log Level: Verbose be 


图 1.29 ”过 滤器 配置 界面 


点 击 “OK”，, 你 会 发 现 多 出 了 一 个 data 过 滤器 。 当 选中 这 个 过 滤器 的 时 候 ， 刚才 在 onCreate() 
方法 里 打印 的 日 志 就 不 见 了 ， 这 是 因为 data 这 个 过 滤器 只 会 显示 tag 名 称 为 data 的 日 志 。 你 可 
以 尝试 在 onCreate( ) 方 法 中 把 打印 日 志 的 语句 改 成 Log.d("data"，"onCreate 
execute") ,然后 再 次 运行 程序 ， 你 就 会 在 data 过 滤 絮 下 看 到 这 行 日 志 


不 知道 你 有 没有 体会 到 使 用 过 滤器 的 好 处 ， 可 能 现在 还 没有 吧 。 不 过 当 你 的 程序 打印 出 成 百 上 
王 行 日 志 的 时 候 ， 你 就 会 迫切 地 需要 过 滤器 了 。 

看 完了 过 滤器 ， 再 来 看 一 下 Logcat 中 的 日 志 级 别 控制 吧 。Logcat 中 主要 有 5 个 级 别 ， 分 别 对 应 
上 一 小 节 介 绍 的 5 个 方法 ， 如 图 1.30 所 示 。 


| Verbose “二 | 


图 1.30 ”Logcat 中 的 日 志 级 别 


当前 我 们 选中 的 级 别 是 Verbose ,也 就 是 最 低 等 级 。 这 意味 着 不 管 我 们 使 用 哪 一 个 方法 打印 日 
志 ， 这 条 日 志 都 一 定 会 显示 出 来 。 而 如 果 我 们 将 级 别 选中 为 Debug ,这 时 只 有 我 们 使 用 Debug 
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及 以 上 级 别 方 法 打印 的 日 志 才 会 显示 出 来 ， 以 此 类 推 。 你 可 以 做 一 下 实验 ， 当 你 把 Logcat 中 的 
级 别 选中 为 Info、Warn 或 者 Error 时 ,我们 在 onCreate ( ) 方 法 中 打印 的 语句 是 不 会 显示 的 ， 
为 我 们 打印 日 志 时 使 用 的 是 Log .d ( ) 方 法 。 


日 志 级 别 控制 的 好 处 就 是 ， 你 可 以 很 快 地 找到 你 所 关心 的 那些 日 志 。 相 信 如 果 让 你 从 上 于 行 日 
志 中 查找 一 条 崩溃 信息 ,你 一 定 会 抓 狂 吧 。 而 现在 你 只 需要 将 日 志 级 别 选中 为 Error , 那些 不 相 
干 的 琐碎 信息 就 不 会 再 干扰 你 的 视线 了 。 


最 后 ， 我 们 再 来 看 一 下 关键 字 过 滤 。 如 果 使 用 过 滤器 加 日 志 级 别 控制 还 是 不 能 锁定 到 你 想 查 看 
的 日 志 内 容 的 话 ， 那 么 还 可 以 通过 关键 字 进 行进 一 步 的 过 滤 ， 如 图 1.31 所 示 。 


roncCreate Regex 


图 1.31 关键 字 输 入 框 

我 们 可 以 在 输入 框 里 输入 关键 字 的 内 容 ， 这样 只 有 符合 关键 字条 件 的 日 志 才 会 显示 出 来 ， 从 而 
能 够 快速 定位 到 任何 你 想 查看 的 日 志 。 另 外 ， 还 有 一 点 需要 注意 ， 关 键 字 过 滤 是 支持 正则 表达 
式 的 , 有 了 这 个 特性 ， 我 们 就 可 以 构建 出 更 加 丰富 的 过 滤 条 件 。 


关于 Android 中 日 志 工 具 的 使 用 ,我 就 准备 讲 到 这 里 ，Logcat 中 其 他 的 一 些 使 用 技巧 就 要 靠 你 
自己 去 摸索 了 。 今 天 你 已 经 学 到 了 足够 多 的 东西 ， 我 们 来 总 结 和 梳理 一 下 吧 。 
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1.5 小结 与 点评 


你 现在 一 定 会 觉得 很 充实 ， 甚 至 有 点 沾沾自喜 。 确 实 应 该 如 此 ， 因 为 你 已 经 成 为 一 名 真正 的 
Android 开 发 者 了 。 通 过 本 章 的 学 习 ， 你 首先 对 Android 系 统 有 了 更 加 充足 的 认识 ， 然 后 成 功 将 
Android 开 发 环境 搭建 了 起 来 ,接着 创建 了 你 自己 的 第 一 个 Android 项 目 ， 并 对 Android 项 目的 
目录 结构 和 执行 过 程 有 了 一 定 的 认识 ， 在 本 章 的 最 后 还 学 习 了 Android 日 志 工 具 的 使 用 ,这 难道 
还 不 够 充实 吗 ? 

不 过 你 也 不 要 过 于 满足 ， 相 信 你 很 清楚 , Android 开 发 者 和 出 色 的 Android 开 发 者 还 是 有 很 大 的 
区 别 的 ， 要 想 成 为 一 名 出 色 的 Android 开 发 者 ， 你 还 需要 付出 更 多 的 努力 才 行 。 现 在 你 可 以 非常 
安心 地 休息 一 段 时 间 ， 因为 今天 你 已 经 做 得 非常 不 错 了 。 储 备 好 能 量 ， 准备 进入 下 一 章 的 旅程 
当中 吧 。 
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第 2 章 探究 新 语言 ,快速 入 门 Kotlin 编 程 


在 Android 系 统 诞 生 的 前 9 年 时 间 里 ,Google 都 只 提供 了 Java 这 一 种 语言 来 开发 Android 应 用 
程序 ， 虽 然 在 Android 1.5 系 统 中 Google 引入 了 NDK 功 能 , 支持 使 用 C 和 C++ 语言 来 进行 一 些 
本 地 化 开发 ， 但 是 这 丝毫 没有 影响 过 java 的 正统 地 位 。 


不 过 从 2017 开 始 ,一切 都 发 生 了 改变 。Google 在 2017 年 的 JJO 大 会 上 宣布 ，Kotlin 正 式 成 为 
Android 的 一 级 开发 语言 ， 和 java 平 起 平 坐 , Android Studio 也 对 Kotlin 进 行 了 全 面 的 支持 。 
两 年 之 后 , Google 又 在 2019 年 的 I/O 大 会 上 宣布 ，Kotlin 已 经 成 为 Android 的 第 一 开发 语言 ， 
虽然 java 仍 然 可 以 继续 使 用 ,但 Google 更 加 推荐 开发 者 使 用 Kotlin 来 编写 Android 应 用 程序 ， 
并 且 未 来 提供 的 官方 API 也 将 会 优先 考虑 Kotlin 版 本 。 


然而 现实 情况 是 ， 很 多 人 对 java 太 熟悉 了 ,不 太 愿 意 花 费 额 外 的 时 间 再 去 学 习 一 门 新 语言 ， 再 
加 上 国内 不 少 公司 对 于 新 技术 比较 保守 ， 不 敢 冒 然 改 用 新 语言 去 承担 一 份额 外 的 风险 ， 因 此 有 目 
前 Kotlin 在 国内 的 普及 程度 并 不 高 。 


可 是 在 海外 ，Kotlin 的 发 展 速度 已 是 势如破竹 。 根 据 统计 ， Google Play 商店 中 排名 前 1000 的 
App 里 ， 有 超过 60% 的 App 已 使 用 了 Kotlin 语 言 ， 并 且 这 个 比例 每 年 还 在 不 断 上 升 。Android 官 
网 文档 的 代码 已 优先 显示 Kotlin 版 本 ， 官 方 的 视频 教程 以 及 Google 的 一 些 开源 项 目 ， 也 改 用 了 
Kotlin 来 实现 。 


为 此 ， 我 坚定 了 使 用 Kotlin 来 编写 本 书 第 3 版 的 信心 。 前 面 已 经 说 了 ， 目 前 国内 Kotlin 的 普及 程 
度 还 不 高 ， 我 希望 这 本 书 能 为 国内 Kotlin 的 推广 和 普及 贡献 一 份 力量 。 


其 实 ， 这 次 编写 第 3 版 对 我 来 说 挑战 还 是 变 大 的 ， 因 为 我 要 在 这 本 书 里 同时 讲 两 门 技术 : Kotlin 
和 Android。Kotlin 是 Android 程 序 的 开发 语言 ,一定 得 先 掌握 语言 才能 开发 Android 程 序 ， 但 
是 如 果 我 们 先 去 学 了 小 半 本 书 的 Kotlin 语 法 ， 然 后 再 开始 学 Android 开 发 ， 这 一 定 会 非常 枯燥 。 
因此 我 准备 将 Kotlin 和 Android 穿 插 在 一 起 讲解 ， 先 通过 一 章 的 内 容 带 你 快速 入 门 Kotlin 编 程 ， 
然后 使 用 目前 已 掌握 的 知识 开始 学 习 Android 开 发 ， 之 后 我 们 每 章 都 会 结合 相应 章节 的 内 容 再 学 
习 一 些 Kotlin 的 进 阶 知识 ， 等 全 部 学 完 本 书 之 后 ， 你 将 能 同时 熟练 地 掌握 Kotlin 和 Android 这 两 
门 技术 。 


如 果 你 还 想 学 习 如 何 使 用 ava 来 开发 Android 应 用 程序 ,那么 请 参阅 本 书 的 第 2 版 。 
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2.1 Kotlin 语 言 简介 


我 想 大 多 数 人 上 听 说 或 知道 Kotlin 的 时 间 并 不 长 ， 但 其 实 它 并 不 是 一 门 很 新 的 语言 。Kotlin 是 由 
JetBrains 公 司 开发 与 设计 的 ， 早 在 2011 年 ,jetBrains 就 公布 了 Kotlin 的 第 一 个 版 本 ， 并 在 
2012 年 将 其 开源 ， 但 在 早期 ， 它 并 没有 受到 太 多 的 关注 。 


2016 年 ，Kotlin 发 布 了 1.0 正 式 版 ， 这 代表 着 Kotlin 已 经 足够 成 熟 和 稳定 了 ， 并 且 JetBrains 也 
在 自家 的 旗舰 IDE 开 发 工具 Intell IDEA 中 加 入 了 对 Kotlin 的 支持 ， 自 此 Android 开 发 语言 终于 
有 了 另外 一 种 选择 ，Kotlin 逐 渐 受 到 广泛 的 关注 。 


接 下 来 的 事情 你 已 经 知道 了 ，2017 年 Google 宣 布 Kotlin 正 式 成 为 Android 一 级 开发 语言 ， 
Android Studio 也 加 入 了 对 Kotlin 的 支持 ，Kotlin 自 此 开始 大 放 异 彩 。 


看 到 这 里 ， 或 许 你 会 产生 一 些 疑 惑 : Android 操 作 系 统 明 明 是 由 Google 开 发 的 ， 为 什么 
JetBrains 作 为 一 个 第 三 方 公司 ， 却 能 够 自己 设计 出 一 门 编程 语言 来 开发 Android 应 用 程序 呢 ? 


想 要 搞 懂 这 个 问题 ， 我 们 得 先 来 探究 一 下 Java 语 言 的 运行 机 制 。 编 程 语言 大 致 可 以 分 为 两 类 : 
编译 型 语言 和 解释 型 语言 。 编 译 型 语言 的 特点 是 编译 器 会 将 我 们 编写 的 源 代码 一 次 性 地 编译 成 
计算 机 可 识别 的 二 进 制 文件 ， 然 后 计算 机 直接 执行 ， 像 C 和 C++ 都 属于 编译 型 语言 。 解 释 型 语 
言 则 完全 不 一 样 ， 它 有 一 个 解释 器 ， 在 程序 运行 时 ， 解 释 器 会 一 行 行 地 读 取 我 们 编写 的 源 代 
码 ,然后 实时 地 将 这 些 源 代码 解释 成 计算 机 可 识别 的 二 进 制 数据 后 再 执行 ， 因 此 解释 型 语言 通 
常 效 率 会 差 一 些 ， 像 Python 和 javaScript 都 属于 解释 型 语言 。 


那么 接 下 来 我 要 考 你 一 个 问题 了 ,java 是 属于 编译 型 语言 还 是 解释 型 语言 呢 ? 对 于 这 个 问题 ， 
即使 是 做 了 很 多 年 java 开 发 的 人 也 可 能 会 答 错 。 有 java 编 程 经 验 的 人 或 许 会 说 ，java 代 码 肯 定 
是 要 先 编译 再 运行 的 ， 初 学 java 的 时 候 都 用 过 javac 这 个 编译 命令 , 因此 Java 属于 编译 型 语言 。 
如 果 这 也 是 你 的 答案 的 话 ， 那 么 恭喜 你 ， 答 错 了 ! 虽然 java 代 码 确实 是 要 先 编译 再 运行 的 ,但 
是 java 代码 编译 之 后 生成 的 并 不 是 计算 机 可 识别 的 二 进 制 文件 ,而 是 一 种 特殊 的 Class 文件 ,这 
种 class 文 件 只 有 Java 虚拟 机 (Android 中 叫 ART ,一 种 移动 优化 版 的 虚拟 机 ) 才能 识别 ,而 这 
个 Java 虚拟 机 担当 的 其 实 就 是 解释 器 的 角色 ，, 它 会 在 程序 运行 时 将 编译 后 的 class 文 件 解 释 成 计 
算 机 可 识别 的 二 进 制 数据 后 再 执行 ， 因 此 ， 准确 来 讲 ,java 属于 解释 型 语言 。 


了 解 了 java 语言 的 运行 机 制 之 后 ,你 有 没有 受到 一 些 启发 呢 ? 其 实 java 虚 拟 机 并 不 直接 和 你 编 
写 的 java 代 码 打 交道 ， 而 是 和 编译 之 后 生成 的 class 文 件 打交道 。 那 么 如 果 我 开发 了 一 门 新 的 编 
程 语言 ， 然后 自己 做 了 个 编译 器 ， 让 它 将 这 门 新 语言 的 代码 编译 成 同样 规格 的 class 文 件 ， Java 
虚拟 机 能 不 能 识别 呢 ? 没 错 ， 这 其 实 就 是 Kotlin 的 工作 原理 了 。jJava 虚 拟 机 不 关心 class 文 件 是 
从 Java 编 译 来 的 ， 还 是 从 Kotlin 编 译 来 的 ， 只 要 是 符合 规格 的 class 文 件 ， 它 都 能 识别 。 也 正 是 
这 个 原因 ,jetBrains 才 能 以 一 个 第 三 方 公司 的 身份 设计 出 一 门 用 来 开发 Android 应 用 程序 的 编 


现在 你 已 经 明白 了 Kotlin 的 工作 原理 ， 但 是 Kotlin 究 竟 凭 借 什么 魅力 能 够 迅速 得 到 广大 开发 者 的 
支持 ， 并 且 仅 在 1.0 版 本 发 布 一 年 后 就 成 为 Android 官 方 支持 的 开发 语言 呢 ? 
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这 就 有 很 多 原因 了 ， 比 如 说 Kotlin 的 语法 更 加 简洁 ,对 于 同样 的 功能 ， 使 用 Kotlin 开 发 的 代码 量 
可 能 会 比 使 用 ava 开 发 的 减少 50% 甚至 更 多 。 另 外 ，Kotlin 的 语法 更 加 高 级 ， 相 比 于 Java 比 较 
老 旧 的 语法 ，Kotlin 增 加 了 很 多 现代 高 级 语言 的 语法 特性 ， 使 得 开发 效率 大 大 提升 。 还 有 ， 
Kotlin 在 语言 安全 性 方面 下 了 很 多 工夫 ， 几 乎 杜绝 了 空 指 针 这 个 全 球衣 溃 率 最 高 的 异常 ， 至 于 是 
如 何 做 到 的 ， 我 们 在 稍 后 就 会 学 到 。 


然而 Kotlin 在 拥有 众多 出 色 的 特性 之 外 ， 还 有 一 个 最 为 重要 的 特性 ， 那 就 是 它 和 Java 是 100% 兼 
容 的 。Kotlin 可 以 直接 调用 使 用 ava 编 写 的 代码 ， 也 可 以 无 缝 使 用 ava 第 三 方 的 开源 库 。 这 使 
得 Kotlin 在 加 入 了 诸多 新 特性 的 同时 ， 还 继承 了 java 的 全 部 财富 。 


那么 既然 Kotlin 和 java 之 间 有 这 样 干 丝 万 缕 的 关系 ,学 习 Kotlin 之 前 是 不 是 必须 先 会 java 呢 ?我 
的 回答 是 : 如 果 你 掌握 了 java 再 来 学 习 Kotlin ， 你 将 会 学 得 更 好 。 如 果 你 没 学 过 java， 但 是 学 
过 其 他 编程 语言 ， 那 么 直接 学 习 Kotlin 也 是 可 以 的 ,只 是 可 能 在 某 些 代码 的 理解 上 , 相 比 有 java 
基础 的 人 会 相对 吃力 一 些 。 而 如 果 你 之 前 没有 任何 编程 基础 ， 那 么 本 书 可 能 不 太 适 合 你 阅读 ， 
建议 你 还 是 先 从 最 基础 的 编程 入 门 书 看 起 。 


另外 ， 本 书 不 会 讲解 任何 java 基 础 方面 的 知识 ， 所 以 如 果 你 准备 先 去 学 习 java 的 话 ， 请 参考 其 
他 相关 书 。 


好 了 ， 对 Kotlin 的 介绍 就 先 讲 这 么 多 吧 ,在 正式 开始 学 习 Kotlin 之 前 ,我们 先 来 学 习 一 下 如 何 将 
一 段 Kotlin 代 码 运 行 起 来 。 
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2.2 如何 运 行 Kotlin 代 码 


本 章 的 目标 是 快速 入 门 Kotlin 编 程 ， 因 此 我 只 会 讲解 Kotlin 方 面 的 知识 ， 整 个 章节 都 不 会 涉及 
Android 开 发 。 既 然 暂 时 和 Android 无 关 了 ， 那么 我 们 首先 要 解决 的 一 个 问题 就 是 怎样 独立 运行 
一 段 Kotlin 代 码 。 


方法 大 概 有 以 下 3 种 ， 下 面 逐 个 进行 介绍 。 


第 一 种 方法 是 使 用 Intellij IDEA。 这 是 JetBrains 的 旗舰 IDE 开 发 工具 ， 对 Kotlin 支 持 得 非常 好 。 
在 Intellij IDEA 里 直接 创建 一 个 Kotlin 项 目 ， 就 可 以 独立 运行 Kotlin 代 码 了 。 但 是 这 种 方法 的 缺 
点 是 你 还 要 再 下 载 安装 一 个 IDE 工 具 ， 有 点 麻烦 ， 因 此 这 里 我 们 就 不 使 用 这 种 方法 了 。 


第 二 种 方法 是 在 线 运 行 Kotlin 代 码 。 为 了 方便 开发 者 快速 体验 Kotlin 编 程 ，jJetBrains 专 门 提供 
了 一 个 可 以 在 线 运行 Kotlin 代 码 的 网 站 , 地址 是 : https://try.kotlinlang.org ,打开 网 站 之 后 的 
页 面 如 图 2.1 所 示 。 


民 固 -> 
ave as Arguments un 


/冰冰 

* We declare a package-level function main which returns Unit and takes 
* an Array of strings as a parameter. Note that semicolons are optional. 
*/ 


fun main() { 
println("Hello, world!") 


图 2.1 在 线 运 行 Kotlin 的 网 站 


只 要 点 击 一 下 右上 方 的 “Run" 按 钮 就 可 以 运行 这 段 Kotlin 代 码 了 ， 非常 简 单 。 但 是 在 线 运 行 
Kotlin 代 码 有 一 个 很 大 的 缺点 ， 就 是 使 用 国内 的 网 络 访问 这 个 网 站 特别 慢 ,而 且 经 常 打 不 开 ， 
此 为 了 学 习 的 稳定 性 着 想 ， 我们 也 不 准备 使 用 这 种 方法 。 


第 三 种 方法 是 使 用 Android Studio。 遗 憾 的 是 ,Android Studio 作 为 一 个 专门 用 于 开发 
Android 应 用 程序 的 工具 ,只 能 创建 Android 项 目 ， 不 能 创建 Kotlin 项 目 。 但 是 没有 关系 ， 我们 
可 以 随便 打开 一 个 Android 项 目 ， 在 里 面 编写 一 个 Kotlin 的 main( ) 函 数 ， 就 可 以 独立 运行 
Kotlin 代 码 了 。 


这 里 就 直接 打开 上 一 章 创 建 的 HelloWorld 项 目 吧 ， 首 先 找到 MainActivity 所 在 的 位 置 ， 如 图 
2.2 所 示 。 
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可 Project ~ 田 三 人 宁 一 
a HelloWorld ~/AndroidStudioProjects/AndroidFirstLine/HelloWorld 
MN .gradle 
.idea 
3 app 
build 
libs 
src 
androidTest 
main 
NM java 


了 com.example.helloworld 


MainActivity 
=res 

四 AndroidManifest.xml 
test 

兰 .gitignore 

3 app.iml 
eR build.gradle 
当 proguard-rules.pro 


坦 1Project | 


Z: Structure 


38S 


图 2.2 HelloWorld 项 目 结构 


接 下 来 在 MainActivity 的 同 级 包 结构 下 创建 一 个 LearnKotlin 文 件 。 右 击 
com.example.helloworld 包 -New 一 Kotlin File/Class , 在 弹出 的 对 话 框 中 输 


入 “LearnKotlin”, 如 图 2.3 所 示 。 点 击 “OK" 即 可 完成 创建 。 


@e® New Kotlin File/Class 
a 1 
Kind: r File Se 


图 2.3 新建 Kotlin 文 件 对 话 框 
接 下 来 , 我们 在 这 个 LearnKotlin 文 件 中 编写 一 个 main( ) 范 数 ， 并 打印 一 行 日 志 ,如 图 2.4 所 
示 。 


区 LearnKotlin.kt 


package com.example.helloworld 


Pp | -fun main() { 
printin("Hello Kotlin!") 


JW 人 WU N 请 


图 2.4 一段 最 简单 的 Kotlin 代 码 
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你 会 发 现 ，main() 函 数 的 左边 出 现 了 一 个 运行 标志 的 小 箭头 。 现 在 我 们 只 要 点 击 一 下 这 个 小 簿 
头 ， 并 且 选 择 第 一 个 Run 选 项 ， 就 可 以 运行 这 段 Kotlin 代 码 了 。 运 行 结果 会 在 Android Studio 
下 方 的 Run 标 签 中 显示 ,如 图 2.5 所 示 。 


Run: ~ com.example.helloworld.LearnKotlinKt 
p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
Hello Kotlin! 


Process finished with exit code 0 


le I 


办 


ml 呀 ! 


江 TODO Terminal Build 三 6:Logcat BB 4:Run 
图 2.5 ”代码 的 运行 结果 
可 以 看 到 ,这 里 成 功 打 印 出 了 Hello Kotlin! 这 句 话 ， 这 说 明 我 们 的 代码 执行 成 功 了 。 


可 能 你 会 问 ， 上 一 章 刚刚 说 到 打印 日 志 尽 量 不 要 使 用 printLn( ) ， 而 是 应 该 使 用 Log， 为 什么 
这 里 却 还 是 使 用 了 printtn() 呢 ?这 是 因为 Log 是 Android 中 提供 的 日 志 工具 类 ， 而 我 们 现在 
是 独立 运行 的 Kotlin 代 码 ， 和 Android 无 关 ， 所 以 自然 是 无 法 使 用 Log 的 。 

这 就 是 在 Android Studio 中 独立 运行 Kotlin 代 码 的 方法 ， 后 面 我 们 都 会 使 用 这 种 方法 来 对 本 章 
所 学 的 内 容 进行 运行 和 测试 。 那 么 接 下 来 ， 就 让 我 们 正式 进入 Kotlin 的 学 习 吧 。 
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2.3 ”编程 之 本 : 变量 和 函数 


编程 语言 之 多 ， 让 人 眼花 综 乱 。 你 可 能 不 知道 ， 世界 上 一 共 诞 生 过 600 多 门 有 记录 的 编程 语言 ， 
没有 记录 的 那 就 更 多 了 。 这 些 编程 语言 基本 上 共有 的 特性 就 是 变量 和 消 数 。 可 以 说 ， 变 量 和 消 
数 就 是 编程 语言 之 本 。 那 么 本 节 我 们 就 来 学 习 一 下 Kotlin 中 变量 和 上 毅 数 的 用 法 。 


2.3.1 变量 


先 来 学 习 变量 。 在 Kotlin 中 定义 变量 的 方式 和 Java 区 别 很 大 ， 在 Java 中 如 果 想 要 定义 一 个 变 
量 ， 需 要 在 变量 前 面 声明 这 个 变量 的 类 型 ， 比 如 说 int a 表示 a 是 一 个 整 型 变量 ， String b 表 
示 b 是 一 个 字符 串 变 量 。 而 Kotlin 中 定义 一 个 变量 ， 只 允许 在 变量 前 声明 两 种 关键 字 : val 和 
Var。 


val (value 的 简写 ) 用 来 声明 一 个 不 可 变 的 变量 ， 这 种 变量 在 初始 赋值 之 后 就 再 也 不 能 重新 赋 
值 ， 对 应 java 中 的 finat 变 量 。 

var (variable 的 简写 ) 用 来 声明 一 个 可 变 的 变量 ,这 种 变量 在 初始 赋值 之 后 仍然 可 以 再 被 重新 
赋值 ， 对 应 Java 中 的 非 final 变 量 。 

如 果 你 有 java 编 程 经 验 的 话 ， 可 能 会 在 这 里 产生 疑惑 ， 仅 仅 使 用 valt 或 者 var 来 声明 一 个 变量 ， 

那么 编译 器 怎么 能 知道 这 个 变量 是 什么 类 型 呢 ? 这 也 是 Kotlin 比 较 有 特色 的 一 点 , 它 拥有 出 色 的 
类 型 推导 机 制 。 


举 个 例子 ， 我 们 打开 上 一 节 创建 的 LearnKotlin 文 件 , 在 main( ) 函数 中 编写 如 下 代码 : 


fun main() { 
val a = 10 
println("a = " + a) 


注意 ，Kotlin 每 一 行 代码 的 结尾 是 不 用 加 分 号 的 ， 如 果 你 写 惯 了 java 的 话 ， 在 这 里 得 先 熟悉 一 
看 


在 上 述 代码 中 ， 我 们 使 用 vat 关 键 字 定义 了 一 个 变量 a， 并 将 它 赋 值 为 10， 这 里 a 就 会 被 自动 扒 
寻 成 整 型 变量 。 因 为 既然 你 要 把 一 个 整数 赋值 给 a， 那么 a 就 只 能 是 整 型 变量 ， 而 如 果 你 要 把 一 
个 字符 串 赋 值 给 a 的 话 ， 那 么 a 就 会 被 自动 推导 成 字符 串 变 量 ， 这 就 是 Kotlin 的 类 型 推导 机 制 。 
现在 我 们 运行 一 下 main( ) 背 数 ， 执行 结 果 如 图 2.6 所 示 ， 正 是 我 们 所 预期 的 。 


Run: ~ com.example.helloworld.LearnKotlinKt 
p "/Applications/Android Studio.app/Contents/ijre/jdk/Contents/Home/bin/java" ... 
a = 10 


Process finished with exit code 0 
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图 2.6 ”打印 变量 a 的 值 
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但 是 Kotlin 的 类 型 推导 机 制 并 不 总 是 可 以 正常 工作 的 ， 比 如 说 如 果 我 们 对 一 个 变量 延迟 赋值 的 
话 ，Kotlin 就 无 法 自动 推导 它 的 类 型 了 。 这 时 候 就 需要 显 式 地 声明 变量 类 型 才 行 ，Kotlin 提 供 了 
对 这 一 功能 的 支持 ， 语 法 如 下 所 示 : 


val a: Int = 10 


可 以 看 到 ， 我 们 显 式 地 声明 了 变量 a 为 Int 类 型 ， 此 时 Kotlin 就 不 会 再 尝试 进行 类 型 推导 了 。 如 
果 现 在 你 尝试 将 一 个 字符 串 赋 值 给 a ， 那 么 编译 器 就 会 抛 出 类 型 不 匹配 的 异常 。 


如 果 你 学 过 java 并 且 足 够 细心 的 话 ， 你 可 能 发 现 了 Kotlin 中 Int 的 首 字 母 是 大 写 的 ， 而 java 中 
int 的 首 字母 是 小 写 的 。 不 要 小 看 这 一 个 字母 大 小 写 的 差距 ， 这 表示 Kotlin 完 全 抛弃 了 Java 中 的 
基本 数据 类 型 ， 全 部 使 用 了 对 象 数据 类 型 。 在 java 中 int 是 关键 字 , 而 在 Kotlin 中 Int 变 成 了 一 
个 类 , 它 拥有 自己 的 方法 和 继承 结构 。 表 2.1 中 列 出 了 java 中 的 每 一 个 基本 数据 类 型 在 Kotlin 中 
对 应 的 对 象 数 据 类 型 。 


表 2.1 Java 和 Kotlin 数 据 类 型 对 照 表 


Java 基 本 数据 类 型 Kotlin 对 象 数据 类 型 数据 类 型 说 明 

int Int 整 型 

Long Long 长 整 型 

short Short 短 整 型 

float Float 单 精度 浮 点 型 

double Double 双 精 度 浮 点 型 
boolean Boolean 布尔 型 

char Char 字符 型 

byte Byte 字 节 型 


接 下 来 我 们 尝试 对 变量 a 进行 一 些 数学 运算 ， 比 如 说 让 a 变 大 10 倍 ， 可 能 你 会 很 自然 地 瑟 出 如 下 
代码 : 


fun main() { 
val a: Int = 10 
a=a* 10 
println("a = " + a) 
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很 遗憾 ， 如 果 你 这 样 写 的 话 ， 编 译 郑 一 定 会 提示 一 个 错误 : Val cannot be reassigned。 这 是 
在 告诉 我 们 ， 使 用 vat 关 键 字 声 明 的 变量 无 法 被 重新 赋值 。 出 现 这 个 问题 的 原因 是 我 们 在 一 开始 
定义 a 的 时 候 将 它 赋值 成 了 10， 然 后 又 在 下 一 行 让 它 变 大 10 倍 ， 这 个 时 候 就 是 对 a 进行 重新 赋值 
了 ， 因 而 编译 器 也 就 报错 了 。 


解决 这 个 问题 的 办 法 也 很 简单 ， 前 面 已 经 提 到 了 ， val 关键 字 用 来 声明 一 个 不 可 变 的 变量 ,而 
var 关 键 字 用 来 声明 一 个 可 变 的 变量 ， 所 以 这 里 只 需要 把 val 改 成 var 即 可 ,如 下 所 示 : 


fun main() { 
var a: Int = 10 
a=a* 10 
println("a = " + a) 


现在 编译 右 就 不 会 再 报错 了 ， 重 新 运行 一 下 代码 ， 结果 如 图 2.7 所 示 。 


Run: ~ com.example.helloworld.LearnKotlinKt 


p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
a = 100 


Process finished with exit code 0 
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图 2.7 打印 变量 a 乘 以 10 的 结果 
可 以 看 到 , a 的 值 变 成 了 100 ,这 说 明 我 们 的 数学 运算 操作 成 功 了 。 


这 里 你 可 能 会 产生 疑惑 : 既然 val 关 键 字 有 这 么 多 的 束缚 ， 为 什么 还 要 用 这 个 关键 字 呢 ? 干脆 全 
部 用 var 关 键 字 不 就 好 了 。 其 实 Kotlin 之 所 以 这 样 设计 ,是 为 了 解决 java 中 final 关 键 字 没 有 被 
合理 使 用 的 问题 。 


在 java 中 ， 除 非 你 主动 在 变量 前 声明 了 final 关 键 字 ， 否则 这 个 变量 就 是 可 变 的 。 然 而 这 并 不 
是 一 件 好 事 ， 当 项 目 变 得 越 来 越 复 杂 ， 参与 开发 的 人 越 来 越 多 时 ， 你 永远 不 知道 一 个 可 变 的 变 
量 会 在 什么 时 候 被 谁 给 修改 了 ， 即 使 它 原 本 不 应 该 被 修改 ， 这 就 经 常会 导致 出 现 一 些 很 难 排查 
的 问题 。 因 此 , 一 个 好 的 编程 习惯 是 ， 除非 一 个 变量 明确 允许 被 修改 ， 否 则 都 应 该 给 它 加 上 
final 关 键 字 。 


但 是 ,不 是 每 个 人 都 能 养 成 这 种 良好 的 编程 习惯 。 我 相信 人 至少 有 90% 的 Java 程 序 员 没有 主动 在 

变量 前 加 上 finatL 关 键 字 的 意识 ， 仅 仅 因 为 java 对 此 是 不 强制 的 。 因 此 ,Kotlin 在 设计 的 时 候 就 
采用 了 和 java 完 全 不 同 的 方式 ， 提供 了 vaL 和 var 这 两 个 关键 字 ， 必 须 由 开发 者 主动 声明 该 变量 
是 可 变 的 还 是 不 可 变 的 。 

那么 我 们 应 该 什么 时 候 使 用 val , 什么 时 候 使 用 var 呢 ? 这 里 我 告诉 你 一 个 小 诀窍 ， 就 是 永远 优 
先 使 用 val 来 声明 一 个 变量 ,而 当 val 没 有 办 法 满足 你 的 需求 时 再 使 用 var。 这 样 设计 出 来 的 程 

序 会 更 加 健壮 ， 也 更 加 符合 高 质量 的 编码 规范 。 


2.3.2 了 荫 数 
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不 少 刚 接触 编程 的 人 对 于 函数 和 方法 这 两 个 概念 有 些 混淆 ， 不 明白 它们 有 什么 区 别 。 其 实 ， 困 
数 和 方法 就 是 同一 个 概念 ， 这 两 种 叫 法 都 是 从 英文 翻译 过 来 的 ， 函 数 翻译 自 function， 方 法 翻 
译 自 method , 它们 并 没有 什么 区 别 ， 只 是 不 同 语言 的 叫 法 习惯 不 一 样 而 已 。 而 因为 Java 中 方 
法 的 叫 法 更 普遍 一 些 ，Kotlin 中 函数 的 叫 法 更 普遍 一 些 ， 因此 本 书 里 可 能 会 交叉 使 用 两 种 叫 法 ， 
你 只 要 知道 它们 是 同一 种 东西 就 可 以 了 ， 不 用 在 这 个 地 方 产生 疑惑 。 

级 数 是 用 来 运行 代码 的 载体 ， 你 可 以 在 一 个 函数 里 编写 很 多 行 代 码 ， 当 运行 这 个 冰 数 时 ， 肯 数 
中 的 所 有 代码 会 全 部 运行 。 像 我 们 前 面 使 用 过 的 main( ) 函数 就 是 一 个 函数 ， 只 不 过 它 比 较 特 
殊 ， 是 程序 的 入 口 沙 数 ， 即 程序 一 旦 运行 ， 就 是 从 main ( ) 函 数 开始 执行 的 。 


但 是 只 有 一 个 main( ) 少 数 的 程序 显然 是 很 初级 的 ， 和 其 他 编程 语言 一 样 ，Kotlin 也 人 允许 我 们 自 
由 地 定义 函数 ， 语 法 规则 如 下 : 


fun methodName(paraml: Int, param2: Int): Int { 
return 0 
} 


下 面 我 来 解释 一 下 上 述 的 语法 规则 , 首先 fun (function 的 简写 ) 是 定义 函数 的 关键 字 ， 无论 你 
定义 什么 函数， 都 一 定 要 使 用 fun 来 声明 。 


紧 跟 在 fun 后 面 的 是 函数 名 ， 这 个 就 没有 什么 要 求 了 ， 你 可 以 根据 自己 的 喜好 起 任何 名 字 ， 但 是 
恨 好 的 编程 习惯 是 六 数 名 最 好 要 有 一 定 的 意义 ， 能 表达 这 个 前 数 的 作用 是 什么 。 


函数 名 后 面 紧 跟 着 一 对 括号 ， 里 面 可 以 声明 该 函数 接收 什么 参数 ， 参 数 的 数量 可 以 是 任意 多 

个 ， 例 如 上 述 示例 就 表示 该 函数 接收 两 个 Int 类 型 的 参数 。 参 数 的 声明 格式 是 “参数 名 : 参数 类 
型 ”, 其 中 参数 名 也 是 可 以 随便 定义 的 ， 这 一 点 和 少数 名 类 似 。 如 果 不 想 接收 任何 参数 ， 那 么 写 
一 对 空 括号 就 可 以 了 。 


参数 括号 后 面 的 那 部 分 是 可 选 的 ， 用 于 声明 该 溺 数 会 返回 什么 类 型 的 数据 ， 上 述 示例 就 表示 该 
级 数 会 返回 一 个 Int 类 型 的 数据 。 如 果 你 的 范 数 不 需要 返回 任何 数据 ， 这 部 分 可 以 直接 不 写 。 
最 后 两 个 大 括号 之 间 的 内 容 就 是 邓 数 体 了 ， 我 们 可 以 在 这 里 编写 一 个 函数 的 具体 逻辑 。 由 于 上 
述 示例 中 声明 了 该 函数 会 返回 一 个 Int 类 型 的 数据 ， 因 此 在 函数 体 中 我 们 简单 地 返回 了 一 个 0。 
这 就 是 定义 一 个 函数 最 标准 的 方式 了 ， 虽 然 Kotlin 中 还 有 许多 其 他 修饰 函数 的 关键 字 ， 但 是 只 要 
掌握 了 上 述 函数 定义 规则 ,你 就 已 经 能 应 对 80% 以 上 的 编程 场景 了 ， 至 于 其 他 的 关键 字 ,我 们 
会 在 后 面 慢 慢 学 习 。 


接 下 来 我 们 尝试 按照 上 述 定义 函数 的 语法 规则 来 定义 一 个 有 意义 的 函数 ,如 下 所 示 : 


fun LargerNumber(num1: Int, num2: Int): Int { 
return max(numl, num2) 
} 


这 里 定义 了 一 个 名 叫 LargerNumber ( ) 的 函数 ， 该 函数 的 作用 很 简单 ， 接 收 两 个 整 型 参数 ， 然 
后 总 是 返回 两 个 参数 中 更 大 的 那个 数 。 
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注意 ,上述 代码 中 使 用 了 一 个 max( ) 函数 ， 这 是 Kotlin 提 供 的 一 个 内 置 永 数 , 它 的 作用 就 是 返回 
两 个 参数 中 更 大 的 那个 数 ， 因 此 我 们 的 LargerNumber ( ) 冰 数 其 实 就 是 对 max ( ) 水 数 做 了 一 层 
封装 而 已 。 


现在 你 可 以 开始 在 LearnKotlin 文 件 中 实现 LargerNumber ( ) 这 个 函数 了 ， 当 你 输入 “max" 这 
个 单词 时 , Android Studio 会 自动 弹出 如 图 2.8 所 示 的 代码 提示 。 


fun LargerNumber(num1: Int, num2: Int): Int { 
return max 
f max(a: Int, b: Int) (kotlin.math) Int ®@ 
D ms max 
max 
f max 
max 
De max 
max0Of 
maxOf 
max0Of 
f max0Of 
f maxOf 


工 mavNf 
^y and 人 ^ 个 will move caret down and up in the editor >> 下 
图 2.8 Android Studio 的 代码 提示 


Android Studio 拥 有 非常 智能 的 代码 提示 和 补 全 功能 ， 通 常 你 只 需要 键入 部 分 代码 ， 它 就 能 
动 预测 你 想 要 编写 的 内 容 ， 并 给 出 相应 的 提示 列表 。 我 们 可 以 通过 上 下 键 在 提示 列表 中 移动 ， 
然后 按 下 “Enter" 键 ，Android Studio 就 会 自动 帮 有 我 们 进行 代码 补 全 了 。 

这 里 我 非常 建议 你 经 常 使 用 Android Studio 的 代码 补 全 功能 ， 可 能 有 些 人 觉得 全 部 手 敲 更 有 成 
就 感 ， 但 是 我 要 提醒 一 句 ， 使 用 代码 补 全 功能 后 ， Android Studio 不 仅 会 帮 有 我 们 补 全 代码 ， 还 
会 帮 有 我 们 自动 导 包 ,这 一 点 是 很 重要 的 。 比 如 说 上 述 的 max ( ) 函数 ， 如 果 你 全 部 手 敲 出 来 ， 那 
么 这 个 函数 一 定 会 提示 一 个 红色 的 错误 ， 如 图 2.9 所 示 。 


package com.example.helloworld 


?java.lang.Integer.max? (multiple choices...) LY 
一 TO argderNmoertrronrr Imc runmZz IJ: Int { 
return max(num1，num2) 


小 
图 2.9 max ( ) 函数 提示 错误 


出 现 这 个 错误 的 原因 是 你 没有 导入 max( ) 盟 数 的 包 。 当 然 ， 导 包 的 方法 也 有 很 多 种 ， 你 将 光标 
移动 到 这 个 红色 的 错误 上 面 就 能 看 到 导 包 的 快捷 键 提示 ， 但 是 最 好 的 做 法 就 是 使 用 Android 
Studio 的 代码 补 全 功能 ， 这 样 导 包 工作 就 自动 完成 了 。 


现在 我 们 使 用 代码 补 全 功能 再 来 编写 一 次 max ( ) 少数 ， 你 会 发 现 LearnKotlin 文 件 的 头 部 自动 导 
入 了 一 个 max ( ) 永 数 的 包 ， 并 且 不 会 再 有 错误 提示 了 “， 如 图 2.10 所 示 。 
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package com,.example,.helloworld 
import kotLin,math,max 


fun largerNumber(numl: Int, num2: Int): Int { 
return max(numl, num2) 


} 


图 2.10 ”自动 导入 max( ) 函数 的 包 


导 包 实际 上 属于 java 的 基础 知识 ， 但 是 鉴于 本 书 上 一 版 出 版 后 ， 有 小 部 分 读者 反馈 按照 书 上 的 
代码 编写 之 后 却 提示 错误 ， 其 实 就 是 没有 正确 导 包 导致 的 ,因此 这 里 我 特意 加 上 了 Android 
studio 代码 补 全 功能 的 说 明 ,希望 你 后 面 可 以 多 多 利用 这 个 功能 ， 就 再 也 没有 导 包 的 困扰 了 。 


现在 LargerNumber ( ) 函数 已 经 编写 好 了 ， 接 下 来 我 们 可 以 党 试 在 nain ( ) 顷 数 中 调用 这 个 函 
数 ， 并 且 实 现在 两 个 数 中 找到 较 大 的 那个 数 这 样 一 个 简单 的 功能 ， 代 码 如 下 所 示 : 


fun main() { 
val a = 37 
val b = 40 
val value = largerNumber(a, b) 
printLn("Larger number is " + value) 


fun LargerNumber(num1: Int, num2: Int): Int { 
return max(numl, num2) 


} 


这 段 代 码 很 简单 ， 我 们 定义 了 a、b 两 个 变量 ，a 的 值 是 37 ,b 的 值 是 40， 然 后 调用 
LargerNumber ( ) 浮 数 ， 并 将 a、b 作 为 参数 传 入 。LargerNumber( ) 函数 会 返回 这 两 个 变量 
中 较 大 的 那个 数 ， 最 后 将 返回 值 打印 出 来 。 现 在 运行 一 下 代码 ， 结 果 如 图 2.11 所 示 。 程 序 正 如 
我 们 预期 的 那样 运行 了 。 


"com.example.helloworld.LearnKotlinKt 
"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
larger number is 40 


Run: 


_ | Process finished with exit code 0 
了 


图 2.11 调用 LargerNumber ( ) 函数 的 运行 结果 


这 就 是 Kotlin 中 最 基本 也 是 最 常用 的 函数 用 法 ， 虽 然 这 里 我 们 实现 的 LargerNumber ( ) 盟 数 很 

简单 ， 但 是 掌握 了 贞 数 的 定义 规则 之 后 ， 你 想 实 现 多 么 复杂 的 亢 数 都 是 可 以 的 。 

在 本 小 节 的 最 后 ， 我 们 再 来 学 习 一 个 Kotlin 函 数 的 语法 糖 ， 这 个 语法 糖 在 以 后 的 开发 中 会 起 到 相 
当 重 要 的 作用 。 

当 一 个 水 数 中 只 有 一 行 代 码 时 ，Kotlin 人 允许 我 们 不 必 编 写 溪 数 体 ， 可 以 直接 将 唯一 的 一 行 代码 写 
在 函数 定义 的 尾部 ， 中 间 用 等 号 连接 即 可 。 比 如 我 们 刚才 编写 的 LargerNumber ( ) 组 数 就 只 有 
一 行 代码 ， 于 是 可 以 将 代码 简化 成 如 下 形式 : 
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fun LargerNumber(num1: Int，num2: Int): Int = max(numl, num2) 


使 用 这 种 语法 ，return 关 键 字 也 可 以 省 略 了 ， 等 号 足以 表达 返回 值 的 意思 。 另 外 ， 还 记得 

Kotlin 出 色 的 类 型 推导 机 制 吗 ? 在 这 里 它 也 可 以 发 挥 重 要 的 作用 。 由 于 max( ) 国 数 返回 的 是 一 个 
Int 值 ， 而 我 们 在 LargerNumber ( ) 级 数 的 尾部 又 使 用 等 号 连接 了 max ( ) 级 数 ,因此 Kotlin 可 
以 推导 出 LargerNumber () 国 数 返回 的 必然 也 是 一 个 Int 值 ,这样 就 不 用 再 显 式 地 声明 返回 值 


类 型 了 ， 代 码 可 以 进一步 简化 成 如 下 形式 : 


fun LargerNumber(num1: Int, num2: Int) = max(numl, num2) 


可 能 你 会 觉得 ， 上 盟 数 只 有 一 行 代码 的 情况 并 不 多 嘛 ， 这 个 语法 糖 也 不 会 很 常用 吧 ? 其 实 并 不 是 
这 样 的 ， 因 为 它 还 可 以 结合 Kotlin 的 其 他 语言 特性 一 起 使 用 ,对 简化 代码 方面 的 帮助 很 大 ， 后 面 


我 们 会 慢 慢 学 习 它 更 多 的 使 用 场景 。 
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2.4 程序 的 逻辑 控制 


程序 的 执行 语句 主要 分 为 3 种 : 顺序 语句 、 条 件 语 句 和 循环 语句 。 顺 序 语 句 很 好 理解 ， 就 是 代码 
PAE 


一 行 一 行 地 往 下 执行 就 可 以 了 ， 但 是 这 种 “ 惯 头 青 " 的 执行 方式 在 很 多 情况 下 并 不 能 满足 我 们 的 
编程 需求 ， 这 时 就 需要 引入 条 件 语句 和 循环 语 名 了“， 下 面 我 们 逐个 进行 介绍 。 


2.4.1 if 条 件 语 句 
Kotlin 中 的 条 件 语句 主要 有 了 两 种 实现 方式 : If 和 when。 


首先 学 习 if ，Kotlin 中 的 让 ff 语句 和 java 中 的 让 f 语 句 几 乎 没有 任何 区 别 ， 因 此 这 里 我 就 简单 举 个 
例子 带 你 快速 了 解 一 下 。 

还 是 以 上 一 节 中 的 LargerNumber () 函数 为 例 ,之 前 我 们 借助 了 Kotlin 内 置 的 mnax ( ) 函数 来 实 
现 返回 两 个 参数 中 的 较 大 值 ， 但 其 实 这 是 没有 必要 的 ， 因 为 使 用 if 判断 同样 可 以 轻松 地 实现 这 
个 功能 。 将 LargerNumber( ) 也 数 的 实现 改 成 如 下 写法 : 


fun LargerNumber(num1: Int, num2: Int): Int { 
var value = 0 
if (numl > num2) { 
value = numl 
} else { 
value = num2 


return value 


} 


[三 有 ye 


这 段 代码 相信 不 需要 我 多 做 解释 ， 任 何 有 编程 基础 的 人 都 应 该 能 看 得 懂 。 但 是 有 一 点 我 还 是 得 
说 明 一 下 ,这 里 使 用 了 var 关 键 字 来 声明 vaLue 这 个 变量 ， 这 是 因为 初始 化 的 时 候 我 们 先 将 
vaLue 赋 值 为 0， 然 后 再 将 它 赋 值 为 两 个 参数 中 更 大 的 那个 数 ,这 就 涉及 了 重新 赋值 ， 因此 必须 
用 var 关 键 字 才 行 。 


到 目前 为 止 ，Kotlin 中 的 if 用 法 和 ava 中 是 完全 一 样 的。 但 注意 我 前 面 说 的 是 “几乎 没有 任何 区 
别 ”"。 也 就 是 说 ,它们 还 是 存在 不 同 之 处 的 ， 那 么 接 下 来 我 们 就 着 重 看 一 下 不 同 的 地 方 。 


Kotlin 中 的 if 语 句 相 比 于 Java 有 一 个 额外 的 功能 , 它 是 可 以 有 返回 值 的 ,返回 值 就 是 if 语 名 每 
一 个 条 件 中 最 后 一 行 代码 的 返回 值 。 因 此 ， 上 述 代码 就 可 以 简化 成 如 下 形式 : 


fun LargerNumber(num1: Int, num2: Int): Int { 
val value = if (numl > num2) { 


return value 


} 
注意 这 里 的 代码 变化 ，if 语 名 使 用 每 个 条 件 的 最 后 一 行 代码 作为 返回 值 ， 并 将 返回 值 赋值 给 了 
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vaLue 变 量 。 由 于 现在 没有 重新 赋值 的 情况 了 ， 因 此 可 以 使 用 vat 关 键 字 来 声明 vaLue 变 量 ， 最 
终 将 vaLue 变 量 返回 。 
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仔细 观察 上 述 代码 ， 你 会 发 现 vaLue 其 实 也 是 一 个 多 余 的 变量 ， 我 们 可 以 直接 将 if 语 名 返回 ， 
这 样 代码 将 会 变 得 更 加 精简 ,如 下 所 示 : 


fun LargerNumber(num1: Int, num2: Int): Int { 
return if (numl > num2) { 


到 这 里 为 止 ， 你 觉得 代码 足够 精简 了 吗 ? 确实 还 不 错 ， 但 是 我 们 还 可 以 做 得 更 好 。 回 顾 一 下 刚 
刚 在 上 一 节 里 学 过 的 语法 糖 ， 当 一 个 冰 数 只 有 一 行 代码 时 ， 可 以 省 略 冰 数 体 部 分 ， 直接 将 这 一 
行 代码 使 用 等 号 串 连 在 冰 数 定义 的 尾部 。 虽 然 上 述 代 码 中 的 LargerNumber ( ) 函数 不 止 只 有 一 
行 代码 ， 但 是 它 和 只 有 一 行 代码 的 作用 是 相同 的 ， 只 是 返回 了 一 下 if 语 名 的 返回 值 而 已 ， 符合 
该 语法 糖 的 使 用 条 件 。 那 么 我 们 就 可 以 将 代码 进一步 精简 : 


fun LargerNumber(num1: Int, num2: Int) = if (numl > num2) { 


前 面 我 之 所 以 说 这 个 语法 糖 非常 重要 ， 就 是 因为 它 除了 可 以 应 用 于 函数 只 有 一 行 代码 的 情况 ， 
还 可 以 结合 Kotlin 的 很 多 语法 来 使 用 ， 所 以 它 的 应 用 场景 非常 广泛 。 


当然 ， 如 果 你 愿意 ， 还 可 以 将 上 述 代 码 再 精简 一 下 ,直接 压缩 成 一 行 代码 : 
fun LargerNumber(num1: Int, num2: Int) = if (numl > num2) numl else num2 


怎么 样 ? 通过 一 个 简单 的 证 语 句 ， 我 们 挖掘 出 了 Kotlin 这 么 多 好 玩 的 语法 特性 ， 现 在 你 应 该 能 
逐渐 体会 到 Kotlin 的 魅力 了 吧 ? 


2.4.2 ”when 条 件 语句 


接 下 来 我 们 开始 学 习 when。Kotlin 中 的 when 语 名 有 点 类 似 于 java 中 的 Switch 语句 ,但 它 又 远 
比 switch 语 句 强大 得 多 。 


如 果 你 熟悉 Java 的 话 ,应 该 知道 java 中 的 Switch 语句 并 不 怎么 好 用 。 首 先 ，switch 只 能 传 入 
整 型 或 短 于 整 型 的 变量 作为 条 件 ，JDK 1.7 之 后 增加 了 对 字符 串 变 量 的 支持 ， 但 如 果 你 的 判断 逻 
辑 使 用 的 并 非 是 上 述 几 种 类 型 的 变量 ， 那 么 不 好 意思 ，switch 并 不 适合 你 。 其 次 ，switch 中 

的 每 个 case 条 件 都 要 在 最 后 主动 加 上 一 个 break , 否则 执行 完 当 前 case 之 后 会 依次 执行 下 面 的 
case ,这 一 特性 曾经 导致 过 无 数 奇 怪 的 bug ， 就 是 因为 有 人 忘记 添加 b reak。 


而 Kotlin 中 的 when 语 名 不 仅 解决 了 上 述 痛 点 ， 还 增加 了 许多 更 为 强大 的 新 特性 ， 有 时 候 它 比 if 
语句 还 要 简单 好 用 ， 现 在 我 们 就 来 学 习 一 下 吧 。 


我 准备 带 你 编写 一 个 查询 考试 成 绩 的 功能 ， 输 入 一 个 学 生 的 姓名 ， 返 回 该 学 生 考 试 的 分 数 。 我 
们 先 用 上 一 小 节 学 习 的 if 语 句 来 实现 这 个 功能 ， 在 LearnKotlin 文 件 中 编写 如 下 代码 : 
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‘fiun getScore(name: String) = if (name == "Tom") { 
} else if (name == "Jim") { 
77 
} else if (name == "Jack") { 
95 
} else if (name == "Lily") { 
100 
} else { 
0 
} 


这 里 定义 了 一 个 getScore() 消 数 ， 这 个 函数 接收 一 个 学 生 姓名 参数 ， 然 后 通过 if 判 断 找到 该 
学 生 对 应 的 考试 分 数 并 返回 。 可 以 看 到 ， 这 里 再 次 使 用 了 单行 代码 水 数 的 语法 糖 ， 正 如 我 所 
说 ， 它 真 的 很 常用 。 


虽然 上 述 代码 确实 可 以 实现 我 们 想 要 的 功能 ,但 是 写 了 这 么 多 的 1f 和 else ,你 有 没有 觉得 代码 
很 元 余 ? 没 错 ， 当 你 的 判断 条 件 非 常 多 的 时 候 ， 就 是 应 该 考虑 使 用 when 语 名 的 时 候 ， 现 在 我 们 
将 代码 改 成 如 下 写法 : 


fun getScore(name: String) = when (name) { 
"Tom" -> 86 
"Jim" -> 77 
"Jack" -> 95 
"Lily" -> 100 
else -> 0 


} 


怎么 样 ? 有 没有 感觉 代码 瞬间 清爽 了 很 多 ? 男 外 你 可 能 已 经 发 现 了 ， when 语句 和 if 语 句 一样 ， 
也 是 可 以 有 返回 值 的 ， 因 此 我 们 仍然 可 以 使 用 单行 代码 肖 数 的 语法 糖 。 


when 语 名 允许 传 入 一 个 任意 类 型 的 参数 ， 然 后 可 以 在 when 的 结构 体 中 定义 一 系列 的 条 件 ， 格 式 


下 
匹配 值 -> { 执行 逻辑 } 
当 你 的 执行 远 辑 只 有 一 行 代码 时 ，{ } 可 以 省 略 。 这 样 再 来 看 上 述 代码 就 很 好 理解 了 吧 ? 


除了 精确 匹配 之 外 ,when 语句 还 允许 进行 类 型 匹配 。 什 么 是 类 型 匹配 呢 ? 这 里 我 再 举 个 例子 。 
定义 一 个 checkNumber ( ) 函 数 ， 如 下 所 示 : 


fun checkNumber(num: Number) { 
when (num) { 
is Int -> println("number is Int") 
is Double -> println("number is Double") 
else -> println("number not support") 


} 


} 


上 述 代码 中 ，is 关 键 字 就 是 类 型 匹配 的 核心 ， 它 相当 于 Java 中 的 jnstanceof 关 键 字 。 由 于 
checkNumber ( ) 范 数 接收 一 个 Number 类 型 的 参数 ， 这 是 Kotlin 内 置 的 一 个 抽象 类 ， 像 Int、 
Long、Float、Double 等 与 数字 相关 的 类 都 是 它 的 子 类 ， 所 以 这 里 就 可 以 使 用 类 型 匹配 来 判 
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断 传 入 的 参数 到 底 属于 什么 类 型 ， 如 果 是 Int 型 或 DoubLe 型 ， 就 将 该 类 型 打印 出 来 ， 否 则 就 打 
印 不 支持 该 参数 的 类 型 。 


现在 我 们 可 以 尝试 在 main ( ) 级 数 中 调用 checkNumber ( ) 冰 数 ， 如 下 所 示 : 


fun main() { 
val num = 10 
checkNumber (num) 


} 


这 里 向 checkNumber( ) 水 数 传 入 了 一 个 Int 型 参数 。 运 行 一 下 程序 ， 结 果 如 图 2.12 所 示 。 


Run: 三 com.example.helloworld.LearnKotlinKt 
p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
number is Int 


Process finished with exit code 0 
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图 2.12 checkNumber( ) 函数 传 入 Int 型 参数 
可 以 看 到 ， 这 里 成 功 判 断 出 了 参数 是 Int 类 型 。 
而 如 果 我 们 将 参数 改 为 Long 型 : 


fun main() { 
val num = 10L 
checkNumber (num) 


重新 运行 一 下 程序 ， 结 果 如 图 2.13 所 示 。 


Run: ™ com.example.helloworld.LearnKotlinKt 
"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 


le number not support 


Process finished with exit code 0 
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图 2.13 checkNumber () 函数 传 入 Long 型 参数 
很 显然 ， 我 们 的 程序 并 不 支持 此 类 型 的 参数 。 


when 语 名 的 基本 用 法 就 是 这 些 ， 但 其 实 when 语 句 还 有 一 种 不 带 参 数 的 用 法 ， 虽 然 这 种 用 法 可 能 
不 太 常 用 ,但 有 的 时 候 却 能 发 挥 很 强 的 扩展 性 。 


拿 刚 才 的 getScore( ) 函 数 举例 ,如果 我 们 不 在 when 语 句 中 传 入 参数 的 话 ， 还 可 以 这 么 写 : 


fun getScore(name: String) = when { 


name == "Tom" -> 86 
name == "Jim" -> 77 
name == "Jack" -> 95 
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name == "Lily" -> 100 
else ->0 


} 


可 以 看 到 ， 这 种 用 法 是 将 判断 的 表达 式 完 整地 写 在 when 的 结构 体 当 中 。 注 意 ，Kotlin 中 判断 字 
符 串 或 对 象 是 否 相等 可 以 直接 使 用 == 关 键 字 ， 而 不 用 像 java 那 样 调用 equatLs ( ) 方 法 。 可 能 你 
会 觉得 这 种 无 参数 的 when 语 名 写 起 来 比较 元 余 ， 但 有 些 场景 必须 使 用 这 种 写法 才能 实现 。 举 个 
例子 ， 假设 所 有 名 字 以 Tom 开 头 的 人 ， 他 的 分 数 都 是 86 分 ， 这 种 场景 如 果 用 带 参 数 的 when 语 名 
来 写 就 无 法 实现 ， 而 使 用 不 带 参 数 的 when 语 名 就 可 以 这 样 写 : 


fun getScore(name: String) = when { 
name.startsWith("Tom") -> 86 
name == "Jim" -> 77 
name == "Jack" -> 95 
name == "Lily" -> 100 
else ->0 

} 


现在 不 管 你 传 入 的 名 字 是 Tom 还 是 Tommy ,只 要 是 以 Tem 开头 的 名 字 ， 他 的 分 数 就 是 86 分 。 


通过 这 一 小 节 的 学 习 ， 相 信 你 也 发 现 了 ，Kotlin 中 的 when 语 句 相 比 于 java 中 的 Switch 语句 要 灵 
活 很 多 ， 希望 你 能 多 写 多 练 ， 并 熟练 掌握 它 的 用 法 。 


2.4.3 ”循环 语句 
学 习 完了 条 件 语句 之 后 ， 接 下 来 我 们 开始 学 习 Kotlin 中 的 循环 语句 。 


熟悉 Java 的 人 应 该 都 知道 ,java 中 主要 有 两 种 循环 语句 : whiLe 循 环 和 for 循 环 。 而 Kotlin 也 提 
供 了 whitLe 循 环 和 for 循 环 ， 其 中 whitLe 循 环 不 管 是 在 语法 还 是 使 用 技巧 上 都 和 java 中 的 
whitLe 循 环 没有 任何 区 别 ， 因 此 我 们 就 直接 跳 过 不 进行 讲解 了 。 如 果 你 没有 学 过 java 也 没有 关 
系 , 只 要 你 学 过 C、C++ 或 其 他 任何 主流 的 编程 语言 , 它们 的 whitLe 循 环 用 法 基本 是 相同 的 。 


下 面 我 们 开始 学 习 Kotlin 中 的 for 循 环 。 


Kotlin 在 for 循 环 方面 做 了 很 大 幅度 的 修改 ,java 中 最 常用 的 for-i 循环 在 Kotlin 中 直接 被 舍弃 
了 ,而 java 中 另 一 种 for-each 循 环 则 被 Kotlin 进 行 了 大 幅度 的 加 强 ， 变 成 了 for- in 循环 ,所 
以 我 们 只 需要 学 习 for- in 循环 的 用 法 就 可 以 了 。 


在 开始 学 习 for- in 循环 之 前 ， 还 得 先 向 你 普及 一 个 区 间 的 概念 ， 因 为 这 也 是 Java 中 没有 的 东 
西 。 我 们 可 以 使 用 如 下 Kotlin 代 码 来 表示 一 个 区 间 : 


val range = 0..10 


这 种 语法 结构 看 上 去 挺 奇怪 的 吧 ? 但 在 Kotlin 中 ， 它 是 完全 合法 的 。 上 述 代码 表示 创建 了 一 个 0 
到 10 的 区 间 ， 并 且 两 端 都 是 闭 区 间 ， 这 意味 着 0 到 10 这 两 个 端点 都 是 包含 在 区 间 中 的 ， 用 数学 
的 方式 表达 出 来 就 是 [0, 10]。 


其 中 ，. .是 创建 两 端 闭 区 间 的 关键 字 ， 在, .的 两 边 指定 区 间 的 左右 端点 就 可 以 创建 一 个 区 间 
Ts 
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有 了 区 间 之 后 ， 我 们 就 可 以 通过 for- in 循环 来 遍历 这 个 区 间 ， 比 如 在 main ( ) 函 数 中 编写 如 下 
代码 : 


fun main() { 
for (i in 0..10) { 


println(i) 


这 就 是 for -in 循 环 最 简单 的 用 法 了 ,我们 遍历 了 区 则 中 的 每 一 个 元 素 ， 并 将 它 打 印 出 来 。 现 在 
运行 一 下 程序 ， 结果 如 图 2.14 所 示 。 


Run: ~ com.example.helloworld.LearnKotlinKt 
> "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java”" ... 
0 
1 
2 
3 3 
4 
艺 | 5 
= | 6 
到 | 三 | 7 
言 8 
办 9 


10 


Process finished with exit code 0 


图 2.14 使 用 for- in 循环 遍历 区 间 


但 是 在 很 多 情况 下 ， 双 端 闭 区 间 却 不 如 单 端 闭 区 间 好 用 。 为 什么 这 么 说 呢 ? 相信 你 一 定 知道 数 
组 的 下 标 都 是 从 0 开始 的 ， 一 个 长 度 为 10 的 数组 ， 它 的 下 标 区 间 范 围 是 0 到 9 ,因此 左 闭 右 开 的 
区 间 在 程序 设计 当中 更 加 常用 。Kotlin 中 可 以 使 用 unti1l 关 键 字 来 创建 一 个 左 闭 右 开 的 区 间 ， 如 
下 所 示 : 


val range = 0 until 10 


上 述 代码 表示 创建 了 一 个 0 到 10 的 左 闭 右 开 区 间 ， 它 的 数学 表达 方式 是 [0, 10)。 修 改 main( ) 函 
数 中 的 代码 ， 使 用 until 替 代 , .关键 字 ， 你 就 会 发 现 最 后 一 行 10 不 会 再 打印 出 来 了 。 


默认 情况 下 ， for - in 循环 每 次 执行 循环 时 会 在 区 间 范 围 内 递增 1， 相 当 于 java for-i 循 环 中 
i++ 的 效果 ， 而 如 果 你 想 跳 过 其 中 的 一 些 元 素 ， 可 以 使 用 step 关 键 字 : 


fun main() { 
for (i in 0 until 10 step 2) { 
println(i) 


} 


上 述 代码 表示 在 遍历 [0, 10) 这 个 区 间 的 时 候 ， 每 次 执行 循环 都 会 在 区 间 范 围 内 递增 2 ， 相 当 于 
for-i 循 环 中 tt = i + 2 的 效果 。 现 在 重新 运行 一 下 代码 ， 结 果 如 图 2.15 所 示 。 
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Run: ~ com.example.helloworld.LearnKotlinKt 
"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 


co on 上 请 由 台 


YJ 


Process finished with exit code 0 


图 2.15 使 用 step 跳 过 区 间 内 的 元 素 


可 以 看 到 ， 现 在 区 间 中 所 有 奇数 的 元 素 都 被 跳 过 了 。 结 合 step 关 键 字 ， 我 们 就 能 够 实现 一 些 更 
加 复杂 的 循环 逻辑 。 


不 过 ， 前 面 我 们 所 学 习 的 . .和 until 关 键 字 都 要 求 区 间 的 左 端 必 须 小 于 等 于 区 间 的 右 端 , 也 就 
是 这 两 种 关键 字 创 建 的 都 是 一 个 升序 的 区 间 。 如 果 你 想 创 建 一 个 降序 的 区 间 ， 可 以 使 用 downTo 
关键 字 ， 用 法 如 下 : 


fun main() { 
for (i in 10 downTo 1) { 
println(i) 


} 


这 里 我 们 创建 了 一 个 [10, 1] 的 降序 区 间 ， 现在 重新 运行 一 下 代码 ， 结 果 如 图 2.16 所 示 。 


Run: 下 com.example.helloworld.LearnKotlinKt 


p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
10 


9 
8 

字 | 7 

6 

沧 5 

= | 
时 3 
| 2 

1 


Process finished with exit code 0 


图 2.16 使 用 downTo 遍 历 降序 区 间 


另外 ， 降序 区 间 也 是 可 以 结合 step 关 键 字 跳 过 区 间 中 的 一 些 元 素 的 ， 这 里 我 就 不 进行 演示 了 ， 
你 可 以 自己 动手 试 一 试 。 


for-in 循 环 除了 可 以 对 区 间 进 行 遍历 之 外 ， 还 可 以 用 于 遍历 数组 和 集合 ， 关 于 集合 这 部 分 内 
容 ， 我们 在 本 章 后 面 的 部 分 就 会 学 到 ， 到 时 候 再 延伸 for- in 循环 的 相关 用 法 。 

如 果 让 我 总 结 一 下 的 话 ， 我 觉得 for- in 循环 并 没有 传统 的 for -i 循环 那样 灵活 ， 但 是 却 比 
for-i 循 环 要 简单 好 用 得 多 ， 而且 足够 覆盖 大 部 分 的 使 用 场景 。 如 果 有 一 些 特殊 场景 使 用 for - 
in 循环 无 法 实现 的 话 ， 我 们 还 可 以 改 用 whitLe 循 环 的 方式 来 进行 实现 。 


好 了 ， 关 于 Kotlin 的 循环 部 分 就 先 讲 这 么 多 吧 。 
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2.5 面向 对 象 编程 


和 很 多 现代 高 级 语言 一 样 ，Kotlin 也 是 面向 对 象 的 ， 因 此 理解 什么 是 面向 对 象 编程 对 我 们 来 说 就 
非常 重要 了 。 关 于 面向 对 象 编程 的 解释 ， 你 可 以 去 看 很 多 标准 化 、 概 念 化 的 定义 ， 但 是 我 觉得 
那些 定义 只 有 本 来 就 懂 的 人 才能 看 得 懂 ， 而 不 了 解 面向 对 象 的 人 ， 即 使 看 了 那些 定义 还 是 不 明 
白 什么 才 是 面向 对 象 编程 。 


因此 , 这 里 我 想 用 自己 的 理解 来 向 你 解释 什么 是 面向 对 象 编程 。 不 同 于 面向 过 程 的 语言 (比如 C 
语言 ) ,面向 对 象 的 语言 是 可 以 创建 类 的 。 类 就 是 对 事物 的 一 种 封装 ， 比 如 说 人 、 汽 车 、 房 
屋 、 书 等 任何 事物 ， 我 们 都 可 以 将 它 封装 一 个 类 ， 类 名 通常 是 名 词 。 而 类 中 又 可 以 拥有 自己 的 
字段 和 函数 ， 字 段 表 示 该 类 所 拥有 的 属性 ,比如 说 人 可 以 有 姓名 和 年 龄 ， 汽 车 可 以 有 品牌 和 价 
格 ， 这些 就 属于 类 中 的 字段 ， 字 段 名 通常 也 是 名 词 。 而 函数 则 表示 该 类 可 以 有 哪些 行为 ， 比 如 
说 人 可 以 吃饭 和 睡觉 ,汽车 可 以 驾驶 和 保养 等 ， 函 数 名 通常 是 动词 。 


通过 这 种 类 的 封装 ， 我 们 就 可 以 在 适当 的 时 候 创建 该 类 的 对 象 ， 然 后 调用 对 象 中 的 字段 和 函数 
来 满足 实际 编程 的 需求 ， 这 就 是 面向 对 象 编程 最 基本 的 思想 。 当 然 ， 面 向 对 象 编程 还 有 很 多 其 
他 特性 ， 如 继承 、 多 态 等 ， 但 是 这 些 特 性 都 是 建立 在 基本 的 思想 之 上 的 ， 理 解 了 基本 思想 之 
后 ， 其 他 的 特性 我 们 可 以 在 后 面 慢 慢 学 习 。 


2.5.1 类 与 对 象 


现在 我 们 就 按照 刚才 所 学 的 基本 思想 来 尝试 进行 面向 对 象 编程 。 首 先 创建 一 个 Person 类 。 右 击 
com.example.helloworld 包 -New 一 Kotlin File/Class , 在 弹出 的 对 话 框 中 输入 “Person”。 
对 话 框 在 默认 情况 下 自动 选中 的 是 创建 一 个 File，File 通 常 是 用 于 编写 Kotlin 顶 层 了 水 数 和 扩展 函 
数 的 ， 我们 可 以 点 击 展开 下 拉 列 表 进行 切换 ,如 图 2.17 所 示 。 


@ @ New Kotlin File/Class 
Name: Person 用 | 
Kind: | 是 File ~ 


Class 
RR Interface 
后 Enum class 
$F Object 


图 2.17 选择 创建 的 类 型 
这 里 选中 Class 表 示 创 建 一 个 类 ， 点 击 “OK” 完 成 创建 ， 会 生成 如 下 所 示 的 代码 : 


class Person { 
} 


这 是 一 个 空 的 类 实现 ， 可 以 看 到 ，Kotlin 中 也 是 使 用 class 关 键 字 来 声明 一 个 类 的 ， 这 一 点 和 
Java 一 致 。 现 在 我 们 可 以 在 这 个 类 中 加 入 字段 和 函数 来 丰富 它 的 功能 ， 这 里 我 准备 加 入 name 和 
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age 字段 ， 以 及 一 个 eat ( ) 函数 ， 因 为 任何 一 个 人 都 有 名 字 和 年 龄 ,也 都 需要 吃饭 。 


class Person { 
var name = "" 
var age = 0 


fun eat() { 
println(name + " is eating. He is " + age + " years old.") 


} 


简单 解释 一 下 ， 这 里 使 用 var 关 键 字 创建 了 name 和 age 这 两 个 字段 ， 这 是 因为 我 们 需要 在 创建 
对 象 之 后 再 指定 具体 的 姓名 和 年 龄 ， 而 如 果 使 用 val 关 键 字 的 话 ， 初 始 化 之 后 就 不 能 再 重新 赋值 
了 。 接 下 来 定义 了 一 个 eat ( ) 水 数 ， 并 在 水 数 中 打印 了 一 名 话 ， 非常 简单 。 


Person 类 已 经 定义 好 了 ， 接 下 来 我 们 看 一 下 如 何 对 这 个 类 进行 实例 化 ,代码 如 下 所 示 : 


val p = Person() 


Kotlin 中 实例 化 一 个 类 的 方式 和 Java 是 基本 类 似 的 ， 只 是 去 掉 了 new 关 键 字 而 已 。 之 所 以 这 么 设 
计 ， 是 因为 当 你 调用 了 有 对 个 类 的 构造 秀 数 时 ， 你 的 意图 只 可 能 是 对 这 个 类 进行 实例 化 ， 因 此 即 
使 没有 new 关 键 字 ， 也 能 清晰 表达 出 你 的 意图 。Kotlin 本 着 最 简化 的 设计 原则 ,将 诸如 new、 行 
尾 分 号 这 种 不 必要 的 语法 结构 都 取消 了 。 


上 述 代码 将 实例 化 后 的 类 赋值 到 了 p 这 个 变量 上 面 , p 就 可 以 称 为 Person 类 的 一 个 实例 ， 也 可 以 
称 为 一 个 对 象 。 


下 面 我 们 开始 在 main ( ) 级 数 中 对 p 对 象 进行 一 些 操作 : 


fun main() { 
val p = Person() 
p.name = "Jack" 
p.age = 19 
p.eat() 


} 


这 里 将 p 对 象 的 姓名 赋值 为 jack， 年 龄 赋值 为 19， 然 后 调用 它 的 eat ( ) 函数 ， 运行 结果 如 图 
2.18 所 示 。 


Run: 三 com.example.helloworld.LearnKotlinKt 
p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Jack is eating., He is 19 years old. 


Process finished with exit code 0 


le 训 


图 2.18 eat ( ) 函数 的 运行 结果 
这 就 是 面向 对 象 编程 最 基本 的 用 法 了 ， 简单 概括 一 下 ， 就 是 要 先 将 事物 封装 成 具体 的 类 ， 然 后 


将 事物 所 拥有 的 属性 和 能 力 分 别 定 义 成 类 中 的 字段 和 函数 ， 接 下 来 对 类 进行 实例 化 ， 再 根据 具 
体 的 编程 需求 调用 类 中 的 字段 和 方法 即 可 。 
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2.5.2 ”继承 与 构造 消 数 


现在 我 们 开始 学 习 面 向 对 象 编程 中 另 一 个 极其 重要 的 特性 一 一 继承 。 继 承 也 是 基于 现实 场景 总 
结 出 来 的 一 个 概念 ， 其 实 非常 好 理解 。 比 如 现在 我 们 要 定义 一 个 student 类 ， 每 个 学 生 都 有 自 
己 的 学 号 和 年 级 ， 因 此 我 们 可 以 在 Student 类 中 加 入 sno 和 grade 字 段 。 但 同时 学 生 也 是 人 
呀 ,学生 也 会 有 姓名 和 年 龄 ,也 需要 吃饭 , 如 果 我 们 在 Student 类 中 重复 定义 name、age 字 段 
和 eat ( ) 涵 数 的 话 就 显得 太 过 元 余 了 。 这 个 时 候 就 可 以 让 Student 类 去 继承 Person 类 ,这样 
Student 就 自动 拥有 了 Person 中 的 字段 和 函数 ， 另 外 还 可 以 定义 自己 独 有 的 字段 和 郧 数 。 
这 就 是 面向 对 象 编程 中 继承 的 思想 ， 很 好 理解 吧 ? 接 下 来 我 们 尝试 用 Kotlin 语 言 实现 上 述 功 能 。 
右 击 com.example.helloworld 包 -New 一 Kotlin File/Class， 在 弹出 的 对 话 框 中 输 

入 “Student”, 并 选择 创建 一 个 CLass， 你 可 以 通过 上 下 按键 快速 切换 创建 类 型 。 


点 击 “OK" 完成 创建 ， 并 在 student 类 中 加 入 学 号 和 年 级 这 两 个 字段 ， 代 码 如 下 所 示 : 


class Student { 
var Sno = "" 
var grade = 0 


现在 Student 和 Person 这 两 个 类 之 间 是 没有 任何 继承 关系 的 ， 想 要 让 Student 类 继承 Person 
类 ,我 们 得 做 两 件 事 才 行 。 


第 一 件 事 ， 使 Person 类 可 以 被 继承 。 可 能 很 多 人 会 觉得 奇怪 ， 尤 其 是 有 Java 编程 经 验 的 人 。 一 
个 类 本 身 不 就 是 可 以 被 继承 的 吗 ? 为 什么 还 要 使 Person 类 可 以 被 继承 呢 ? 这 就 是 Kotlin 不 同 的 
地 方 ， 在 Kotlin 中 任何 一 个 非 抽 象 类 默认 都 是 不 可 以 被 继承 的 ， 相 当 于 java 中 给 类 声明 了 final 
关键 字 。 之 所 以 这 么 设计 ， 其 实 和 val 关 键 字 的 原因 是 差不多 的 ， 因 为 类 和 变量 一 样 ， 最 好 都 是 
不 可 变 的 ， 而 一 个 类 人 允许 被 继承 的 话 ， 它 无 法 预知 子 类 会 如 何 实现 ， 因 此 可 能 就 会 存在 一 些 未 
知 的 风险 。Effective Java 这 本 书 中 明确 提 到 ,如果 一 个 类 不 是 专门 为 继承 而 设计 的 ， 那 么 就 应 
该 主动 将 它 加 上 final 声 明 ， 禁止 它 可 以 被 继承 。 


很 明显 ，Kotlin 在 设计 的 时 候 遵 循 了 这 条 编程 规范 ， 默 认 所 有 非 抽 象 类 都 是 不 可 以 被 继承 的 。 之 
所 以 这 里 一 直 在 说 非 抽象 类 ， 是 因为 抽象 类 本 身 是 无 法 创建 实例 的 ， 一 定 要 由 子 类 去 继承 它 才 
能 创建 实例 ， 因 此 抽象 类 必须 可 以 被 继承 才 行 ， 要 不 然 就 没有 意义 了 。 由 于 Kotlin 中 的 抽象 类 和 
java 中 并 无 区 别 ， 这 里 我 就 不 再 多 讲 了 。 


既然 现在 Person 类 是 无 法 被 继承 的 ， 我 们 得 让 它 可 以 被 继承 才 行 ， 方 法 也 很 简单 ， 在 Person 
类 的 前 面 加 上 open 关 键 字 就 可 以 了 ， 如 下 所 示 : 


open class Person { 


} 


加 上 open 关 键 字 之 后 ,我们 就 是 在 主动 告诉 Kotlin 编 译 器 ，Person 这 个 类 是 专门 为 继承 而 设计 
的 , 这 样 Person 类 就 允许 被 继承 了 。 


第 二 件 事 ， 要 让 Student 类 继承 Person 类 。 在 Java 中 继承 的 关键 字 是 extends ，, 而 在 Kotlin 
中 变 成 了 一 个 冒号 ， 写 法 如 下 : 
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class Student : Person() { 
Var Sno = "" 
var grade = 0 


继承 的 写法 如 果 只 是 替换 一 下 关键 字 倒 也 挺 简 单 的 ， 但 是 为 什么 Person 类 的 后 面 要 加 上 一 对 括 
号 呢 ?Java 中 继承 的 时 候 好 像 并 不 需要 括号 。 对 于 初学 Kotlin 的 人 来 讲 ， 这 对 括号 确实 挺 难 理解 
的 ,也 可 能 是 Kotlin 在 这 方面 设计 得 太 复杂 了 ， 因 为 它 还 涉及 主 构 造 溺 数 、 次 构造 孔 数 等 方面 的 
知识 ， 这 里 我 尽量 举 试用 最 简单 易 懂 的 讲述 来 让 你 理解 这 对 括号 的 意义 和 作用 ， 同 时 顺便 学 习 
一 下 Kotlin 中 的 主 构造 水 数 和 次 构造 水 数 。 


任何 一 个 面向 对 象 的 编程 语言 都 会 有 构造 水 数 的 概念 ，Kotlin 中 也 有 ,但 是 Kotlin 将 构造 函数 分 
成 了 两 种 : 主 构造 函数 和 次 构造 函数 。 


主 构造 函数 将 会 是 你 最 常用 的 构造 函数 ， 每 个 类 默认 都 会 有 一 个 不 带 参 数 的 主 构造 裔 数 ， 当 然 
你 也 可 以 显 式 地 给 它 指明 参数 。 主 构造 函数 的 特点 是 没有 函数 体 ， 直 接 定义 在 类 名 的 后 面 即 
可 。 比 如 下 面 这 种 写法 : 


class Student(val sno: String, val grade: Int) : Person() { 


这 里 我 们 将 学 号 和 年 级 这 两 个 字段 都 放 到 了 主 构造 永 数 当中 ， 这 就 表明 在 对 student 类 进行 实 
例 化 的 时 候 ， 必须 传 入 构造 水 数 中 要 求 的 所 有 参数 。 比 如 : 


val student = Student("al23", 5) 


这 样 我 们 就 创建 了 一 个 student 的 对 象 ， 同 时 指定 该 学 生 的 学 号 是 a123， 年 级 是 5。 另 外 ， 由 
于 构造 函数 中 的 参数 是 在 创建 实例 的 时 候 传 入 的 ， 不 像 之 前 的 写法 那样 还 得 重新 赋值 ， 因 此 我 
们 可 以 将 参数 全 部 声明 成 val。 


你 可 能 会 问 ， 主 构造 函数 没有 函数 体 ， 如 果 我 想 在 主 构造 函数 中 编写 一 些 逻 辑 ， 该 怎么 办 呢 ? 
Kotlin 给 我 们 提供 了 一 个 jnit 结 构 体 ,所 有 主 构造 函数 中 的 逻辑 都 可 以 写 在 里 面 : 
class Student(val sno: String, val grade: Int) : Person() { 


init { 
println("sno is " + sno) 


println("grade is " + grade) 


这 里 我 只 是 简单 打印 了 一 下 学 号 和 年 级 的 值 ， 现 在 如 果 你 再 去 创建 一 个 student 类 的 实例 ， 一 
定 会 将 构造 衣 数 中 传 入 的 值 打印 出 来 。 


到 这 里 为 止 都 还 返 好 理解 的 吧 ? 但 是 这 和 那 对 括号 又 有 什么 关系 呢 ? 这 就 涉及 了 Java 继承 特性 
中 的 一 个 规定 ， 子 类 中 的 构造 永 数 必须 调用 父 类 中 的 构造 永 数 ， 这 个 规定 在 Kotlin 中 也 要 遵守 。 


那么 回头 看 一 下 Student 类 ， 现 在 我 们 声明 了 一 个 主 构造 水 数 ， 根 据 继承 特性 的 规定 ， 子 类 的 
构造 水 数 必须 调用 父 类 的 构造 函数 ， 可 是 主 构 造 沙 数 并 没有 函数 体 ， 我 们 怎样 去 调用 父 类 的 构 
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造 遂 数 呢 ? 你 可 能 会 说 ， 在 init 结 构 体 中 去 调用 不 就 好 了 。 这 或 许 是 一 种 办 法 ， 但 绝对 不 是 一 
种 好 办 法 ， 因 为 在 绝 大 多 数 的 场景 下 ， 我 们 是 不 需要 编写 init 结 构 体 的 。 


Kotlin 当 然 没 有 采用 这 种 设计 ， 而 是 用 了 另外 一 种 简单 但 是 可 能 不 太 好 理解 的 设计 方式 : 括号 。 
子 类 的 主 构造 函数 调用 父 类 中 的 哪个 构造 永 数 ， 在 继承 的 时 候 通 过 括号 来 指定 。 因 此 再 来 看 一 
遍 这 段 代 码 ， 你 应 该 就 能 理解 了 吧 。 


class Student(val sno: String, val grade: Int) : Person() { 


在 这 里 ，Person 类 后 面 的 一 对 空 括号 表示 Student 类 的 主 构造 函数 在 初始 化 的 时 候 会 调用 
Person 类 的 无 参数 构造 水 数 ， 即 使 在 无 参数 的 情况 下 ， 这 对 括号 也 不 能 省 略 。 


而 如 果 我 们 将 Person 改 造 一 下 ， 将 姓名 和 年 龄 都 放 到 主 构造 永 数 当中 ， 如 下 所 示 : 


open class Person(val name: String, val age: Int) { 


} 


此 时 你 的 Student 类 一 定 会 报错 ， 当然， 如 果 你 的 main ( ) 函数 还 保留 着 之 前 创建 Pe rson 实 例 
的 代码 ， 那 么 这 里 也 会 报错 ， 但 是 它 和 我 们 接 下 来 要 讲 的 内 容 无 关 ， 你 可 以 自己 修正 一 下 ,或 
者 干脆 直接 删 掉 这 部 分 代码 。 


现在 回 到 Student 类 当中 ， 它 一 定 会 提示 如 图 2.19 所 示 的 错误 。 


EStudent.kt 


package com.example.helloworld 
class Student(val sno: String, val grade: Int) : Person() { 
init { No value passed for parameter 'age' 


println("sno is " + sno) 


下 U 
pripeio( eae Te ove) No value passed for parameter 'name 


} 
图 2.19 Student 类 提示 错误 


这 里 出 现 错误 的 原因 也 很 明显 ，Person 类 后 面 的 空 括号 表示 要 去 调用 Person 类 中 无 参 的 构造 
函数 ， 但 是 Person 类 现在 已 经 没有 无 参 的 构造 水 数 了 ， 所 以 就 提示 了 上 述 错 误 。 


如 果 我 们 想 解决 这 个 错误 的 话 ， 就 必须 给 Person 类 的 构造 水 数 传 和 name 和 age 字段 ,可 是 
student 类 中 也 没有 这 两 个 字段 呀 。 很 简单 ， 没 有 就 加 响 。 我 们 可 以 在 student 类 的 主 构造 函 
数 中 加 上 name 和 age 这 两 个 参数 ， 再 将 这 两 个 参数 传 给 Person 类 的 构造 遂 数 ， 代 码 如 下 所 示 : 


class Student(val sno: String, val grade: Int, name: String, age: Int) : 
Person(name, age) { 


} 
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注意 ， 我 们 在 Student 类 的 主 构造 函数 中 增加 name 和 age 这 两 个 字段 时 ， 不 能 再 将 它们 声明 成 
VvatL， 因 为 在 主 构造 水 数 中 声明 成 vat 或 者 var 的 参数 将 自动 成 为 该 类 的 字段 ， 这 就 会 导致 和 父 
类 中 同名 的 name 和 age 字段 造成 冲突 。 因 此 , 这 里 的 name 和 age 参数 前 面 我 们 不 用 加 任何 关键 
字 ，, 让 它 的 作用 域 仅 限 定 在 主 构造 亢 数 当中 即 可 。 


现在 就 可 以 通过 如 下 代码 来 创建 一 个 student 类 的 实例 : 


val student = Student("al23", 5, "Jack", 19) 


学 到 这 里 ， 我 们 就 将 Kotlin 的 主 构 造 消 数 基 本 掌握 了 ， 是 不 是 觉得 继承 时 的 这 对 括号 问题 也 不 是 
那么 难以 理解 ?但 是 ，Kotlin 在 括号 这 个 问题 上 的 复杂 度 并 不 仅 限 于 此 ， 因 为 我 们 还 没 涉及 
Kotlin 构 造 水 数 中 的 另 一 个 组 成 部 分 一 一 次 构造 水 数 。 


其 实 你 几乎 是 用 不 到 次 构造 溺 数 的 ，Kotlin 提 供 了 一 个 给 时 数 设 定 参 数 默 认 值 的 功能 ， 基 本 上 可 
以 替代 次 构造 孙 数 的 作用 ， 我 们 会 在 本 章 最 后 学 习 这 部 分 内 容 。 但 是 考虑 到 知识 结构 的 完整 

性 ,我 决定 还 是 介绍 一 下 次 构造 冰 数 的 相关 知识 ， 顺 便 探讨 一 下 括号 问题 在 次 构造 当 数 上 的 区 
别 。 


你 要 知道 ， 任 何 一 个 类 只 能 有 一 个 主 构造 淆 数 ， 但 是 可 以 有 多 个 次 构造 溺 数 。 次 构造 函数 也 可 
以 用 于 实例 化 一 个 类 ， 这 一 点 和 主 构 造 函 数 没有 什么 不 同 ， 只 不 过 它 是 有 函数 体 的 。 


Kotlin 规 定 ， 当 一 个 类 既 有 主 构造 函数 又 有 次 构造 衣 数 时 ， 所 有 的 次 构造 永 数 都 必须 调用 主 构造 
级 数 (包括 间接 调用 ) 。 这 里 我 通过 一 个 具体 的 例子 就 能 简单 前 明 ， 代 码 如 下 : 


class Student(val sno: String, val grade: Int, name: String, age: Int) : 
Person(name, age) { 
constructor(name: String, age: Int) : this("", 0, name, age) { 


constructor() : this("", 0) { 


} 


次 构造 范 数 是 通过 const ructor 关 键 字 来 定义 的 ， 这 里 我 们 定义 了 两 个 次 构造 浮 数 : 第 一 个 次 
构造 函数 接收 name 和 age 参数 ， 然 后 它 又 通过 this 关 键 字 调用 了 主 构造 函数 ， 并 将 sno 和 
grade 这 两 个 参数 赋值 成 初始 值 ; 第 二 个 次 构造 函数 不 接收 任何 参数 , 它 通过 this 关 键 字 调用 
了 我 们 刚才 定义 的 第 一 个 次 构造 函数 ， 并 将 name 和 age 参数 也 赋值 成 初始 值 , 由 于 第 二 个 次 构 
造 函 数 间接 调用 了 主 构造 函数 ， 因 此 这 仍然 是 合法 的 。 


那么 现在 我 们 就 拥有 了 3 种 方式 来 对 Student 类 进行 实体 化 ， 分 别 是 通过 不 带 参 数 的 构造 函数 、 
通过 带 两 个 参数 的 构造 师 数 和 通过 带 4 个 参数 的 构造 水 数 ， 对 应 代码 如 下 所 示 : 


val studentl1 = Student () 
val student2 = Student("Jack", 19) 
val student3 = Student("al23", 5, "Jack", 19) 


这 样 我 们 就 将 次 构造 光 数 的 用 法 掌握 得 差不多 了 ， 但 是 到 目前 为 止 ， 继 承 时 的 括号 问题 还 没有 
进一步 延伸 ， 和 暂时 和 之 前 学 过 的 场景 是 一 样 的 。 
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那么 接 下 来 我 们 就 再 来 看 一 种 非常 特殊 的 情况 : 类 中 只 有 次 构造 函数， 没有 主 构 造 水 数 。 这 种 
情况 真 的 十 分 少见 ， 但 在 Kotlin 中 是 允许 的 。 当 一 个 类 没有 显 式 地 定义 主 构 造 沙 数 且 定义 了 次 构 
造 函 数 时 ， 它 就 是 没有 主 构造 函数 的 。 我 们 结合 代码 来 看 一 下 : 


class Student : Person { 
constructor(name: String, age: Int) : super(name, age) { 


} 


注意 这 里 的 代码 变化 ， 首先 Student 类 的 后 面 没有 显 式 地 定义 主 构造 函数 ， 同 时 又 因为 定义 了 
次 构造 函数， 所 以 现在 Student 类 是 没有 主 构 造 孙 数 的。 那么 既然 没有 主 构造 沙 数 ， 继 承 

Person 类 的 时 候 也 就 不 需要 再 加 上 括号 了 。 其 实 原因 就 是 这 么 简单 ， 只 是 很 多 人 在 刚 开始 学 习 
Kotlin 的 时 候 没 能 理解 这 对 括号 的 意义 和 规则 ,因此 总 感觉 继承 的 写法 有 时 候 要 加 上 括号 ， 有 时 
候 又 不 要 加 ， 搞 得 早 头 转向 的 ， 而 在 你 真正 理解 了 规则 之 后 ， 就 会 发 现 其实 还 是 很 好 懂 的 。 


另外 ,由 于 没有 主 构造 水 数 ， 次 构造 永 数 只 能 直接 调用 父 类 的 构造 永 数 ， 上 述 代 码 也 是 将 this 
关键 字 换 成 了 super 关 键 字 ， 这 部 分 就 很 好 理解 了 ， 因 为 和 Java 比较 像 ， 我 也 就 不 再 多 说 了 。 


这 一 小 节 我 们 对 Kotlin 的 继承 和 构造 少数 的 问题 探究 得 比较 深 , 同时 这 也 是 很 多 人 新 上 于 Kotlin 
时 比较 难 理解 的 部 分 ， 希望 你 能 好 好 掌握 这 部 分 内 容 。 


2.5.3 接口 


上 一 小 节 的 内 容 比较 长 ， 也 偏 复 杂 一 些 ， 可 能 学 起 来 有 些 辛 苦 。 本 小 节 的 内 容 就 简单 多 了 ， 
为 Kotlin 中 的 接口 部 分 和 java 几 乎 是 完全 一 致 的 。 


接口 是 用 于 实现 多 态 编程 的 重要 组 成 部 分 。 我 们 都 知道 ，java 是 单 继承 结构 的 语言 ， 任 何 一 个 
类 最 多 只 能 继承 一 个 父 类 ， 但 是 却 可 以 实现 任意 多 个 接口 ，Kotlin 也 是 如 此 。 


我 们 可 以 在 接口 中 定义 一 系列 的 抽象 行为 ， 然 后 由 具体 的 类 去 实现 。 下 面 还 是 通过 具体 的 代码 
来 学 习 一 下 ， 首 先 创 建 一 个 study 接口 ， 并 在 其 中 定义 几 个 学 习 行为 。 右 击 
com.example.helloworld 包 ->New-=:Kotlin File/Class ，, 在 弹出 的 对 话 框 中 输入 “Study”, 创 
建 类 型 选择 “Interface”。 


然后 在 Study 接 口中 添加 几 个 学 习 相 关 的 函数 ， 注 意 接口 中 的 函数 不 要 求 有 上 国 数 体 ， 代 码 如 下 
所 示 : 


interface Study { 
fun readBooks() 
fun doHomework() 


} 


接 下 来 就 可 以 让 Student 类 去 实现 Study 接 口 了 , 这 里 我 将 Student 类 原 有 的 代码 调整 了 一 
下 ， 以 突出 继承 父 类 和 实现 接口 的 区 别 : 


class 9tudent (name: String, age: Int) : Person(name, age), Study { 
override fun readBooks() { 
println(name + " is reading.") 
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override fun doHomework() { 
println(name + " is doing homework.") 


} 


熟 型 ava 的 人 一 定 知道 ,java 中 继承 使 用 的 关键 子 是 extends， 实 现 接口 使 用 的 关键 字 是 
impLements ,而 Kotlin 中 统一 使 用 冒号 ， 中 间 用 去 号 进行 分 隔 。 上 述 代码 就 表示 Student 类 
继承 了 Person 类 ， 同 时 还 实现 了 Study 接 口 。 另 外 接口 的 后 面 不 用 加 上 括号 ， 因 为 它 没有 构造 
纹 数 可 以 去 调用 。 


Study 接 口中 定义 了 readBooks( ) 和 doHomework () 这 两 个 待 实现 函数 ， 因 此 Student 类 必 
须 实现 这 两 个 阔 数 。Kotlin 中 使 用 override 关 键 字 来 重 写 父 类 或 者 实现 接口 中 的 浮 数 ， 这 里 我 
们 只 是 简单 地 在 实现 的 函数 中 打印 了 一 行 日 志 。 


现在 我 们 可 以 在 main( ) 消 数 中 编写 如 下 代码 来 调用 这 两 个 接口 中 的 函数 : 


fun main() { 
val student = Student("Jack", 19) 
doStudy(student) 


fun doStudy(study: Study) { 
study.readBooks() 
study.doHomework() 

} 


这 里 为 了 向 你 演示 一 下 多 态 编程 的 特性 ， 我 故意 将 代码 写 得 复杂 了 一 点 。 首 先 创 建 了 一 个 
Student 类 的 实例 ， 本 来 是 可 以 直接 调用 该 实例 的 readBooks ( ) 和 doHomework ( ) 涵 数 的 ， 
但 是 我 没有 这 么 做 ， 而 是 将 它 传 入 到 了 doStudy () 函数 中 。doStudy () 函数 接收 一 个 Study 类 
型 的 参数 ， 由 于 Student 类 实现 了 Study 接 口 ， 因此 Student 类 的 实例 是 可 以 传递 给 
doStudy ( ) 函数 的 ， 接 下 来 我 们 调用 了 Study 接 口 的 readBooks ( ) 和 doHomework() 子 数 ， 
这 种 就 叫 作 面向 接口 编程 ， 也 可 以 称 为 多 态 。 


现在 运行 一 下 代码 ， 结 果 如 图 2.20 所 示 。 


Run: 在 com.example.helloworld.LearnKotlinKt 

"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" . . . 
Jack is reading， 

Jack is doing homework. 


Pp 


Process finished with exit code 0 
= 了 


图 2.20 ”调用 接口 中 的 函数 

这 样 我 们 就 将 Kotlin 中 接口 的 用 法 基本 学 完了 ， 是 不 是 很 简单 ? 不 过 为 了 让 接口 的 功能 更 加 灵 
活 ，Kotlin 还 增加 了 一 个 额外 的 功能 : 允许 对 接口 中 定义 的 函数 进行 默认 实现 。 其 实 Jjava 在 JDK 
1.8 之 后 也 开始 支持 这 个 功能 了 ， 因此 总 体 来 说 ，Kotlin 和 java 在 接口 方面 的 功能 仍然 是 一 模 一 
样 的 。 


下 面 我 们 学 习 一 下 如 何 对 接口 中 的 函数 进行 默认 实现 ， 修 改 Study 接 口中 的 代码 ,如 下 所 示 : 
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interface Study { 
fun readBooks () 


fun doHomework() { 
println("do homework default implementation.") 


} 


可 以 看 到 ， 我们 给 doHomework( ) 国 数 加 上 函数 体 ， 并且 在 里 面 打印 了 一 行 日 志 。 如 果 接 口 
中 的 一 个 函数 拥有 了 上 浮 数 体 ， 这 个 函数 体 中 的 内 容 就 是 它 的 默认 实现 。 现 在 当 一 个 类 去 实现 
Study 接 口 时 ， 只 会 强制 要 求实 现 readBooks ( ) 范 数 , 而 doHomework ( ) 函 数 则 可 以 自由 选择 
实现 或 者 不 实现 ， 不 实现 时 就 会 自动 使 用 默认 的 实现 逻辑 。 


现在 回 到 Student 类 当中 ， 你 会 发 现 如 果 我 们 删除 了 doHomewo rk ( ) 函数， 代码 是 不 会 提示 错 
误 的 ， 而 删除 readBooks ( ) 函数 则 不 行 。 当 删除 了 doHomework ( ) 函数 之 后 ,重新 运行 
main() 范 数 ,结果 如 图 2.21 所 示 。 可 以 看 到 ， 程 序 正如 我 们 所 预期 的 那样 运行 了 。 


Run: ~ com.example.helloworld.LearnKotlinKt 

"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Jack is reading， 

do homework default impLementation， 


Pp 


Process finished with exit code 0 
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2.21 调用 接口 的 默认 实现 函数 


现在 你 已 经 掌握 了 Kotlin 面 向 对 象 编程 中 最 主要 的 一 些 内 容 ， 接 下 来 我 们 再 学 习 一 个 和 java 相 比 
变化 比较 大 的 部 分 一 一 函数 的 可 见 性 修饰 符 。 


熟 炙 Java 的 人 一 定 知道 ,java 中 有 pubLic、private、protected 和 defauLt (什么 都 不 
写 ) 这 4 种 函数 可 见 性 修饰 符 。Kotlin 中 也 有 4 种 ， 分 别 是 pubLic、private、protected 和 
internal , 需要 使 用 哪 种 修饰 符 时 ， 直接 定义 在 fun 关 键 字 的 前 面 即 可 。 下 面 我 详细 介绍 一 下 
java 和 Kotlin 中 这 些 函 数 可 见 性 修饰 符 的 异同 。 


首先 private 修 饰 符 在 两 种 语言 中 的 作用 是 一 模 一 样 的 ， 都 表示 只 对 当前 类 内 部 可 见 。pubLic 
修饰 符 的 作用 虽然 也 是 一 致 的 ， 表 示 对 所 有 类 都 可 见 ， 但 是 在 Kotlin 中 pubLic 修 饰 符 是 默认 

项 ,而 在 java 中 defauLt 才 是 默认 项 。 前 面 我 们 定义 了 那么 多 的 函数 ， 都 没有 加 任何 的 修饰 

符 ,所 以 它们 默认 都 是 pubLic 的 。protected 关 键 字 在 java 中 表示 对 当前 类 、 子 类 和 同一 包 
路 径 下 的 类 可 见 ,在 Kotlin 中 则 表示 只 对 当前 类 和 子 类 可 见 。Kotlin 抛 弃 了 Java 中 的 defauLt 可 
见 性 (同一 包 路 径 下 的 类 可 见 ) ， 引 入 了 一 种 新 的 可 见 性 概念 ， 只 对 同一 模块 中 的 类 可 见 ， 使 
用 的 是 internal 修 饰 符 。 比 如 我 们 开发 了 一 个 模块 给 别人 使 用 ， 但 是 有 一 些 水 数 只 人 允许 在 模块 
内 部 调用 ， 不想 暴露 给 外 部 ， 就 可 以 将 这 些 函 数 声明 成 internaL。 关 于 模块 开发 的 内 容 ， 我们 
会 在 本 书 的 最 后 一 章 学 习 。 


表 2.2 更 直观 地 对 比 了 Java 和 Kotlin 中 六 数 可 见 性 修饰 符 之 间 的 区 别 。 
表 2.2 Java 和 Kotlin 函 数 可 见 性 修饰 符 对 照 表 
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修饰 符 Java Kotlin 


public 所 有 类 可 见 所 有 类 可 见 (默认 ) 
private 当前 类 可 见 
protected 当前 类 、 子 类 、 同 一 包 路 径 下 的 类 可 见 当前 类 、 子 类 可 见 
default 同一 包 路 径 下 的 类 可 见 (默认 ) 无 

internal 无 同一 模块 中 的 类 可 见 


2.5.4 数据 类 与 单 例 类 


在 面向 对 象 编程 这 一 节 ,我 们 已 经 学 习 了 很 多 的 知识 ， 那 么 在 本 节 的 最 后 我 们 再 来 了 解 几 个 
Kotlin 中 特有 的 知识 点 ， 从 而 圆满 完成 本 节 的 学 习 任务 。 


在 一 个 规范 的 系统 架构 中 ， 数 据 类 通常 占据 着 非常 重要 的 角色 ,它们 用 于 将 服务 器 端 或 数据 库 
中 的 数据 映射 到 内 存 中 ， 为 编程 逻辑 提供 数据 模型 的 支持 。 或 许 你 听 说 过 MVC、MVP、MVVM 
之 类 的 架构 模式 ， 不 管 是 哪 一 种 架构 模式 ， 其 中 的 M 指 的 就 是 数据 类 。 


数据 类 通常 需要 重 写 equaLs ( ) 、hashCode()、toString () 这 几 个 方法 。 其 中 , equats ( ) 
方法 用 于 判断 两 个 数据 类 是 否 相 等 。hashCode ( ) 方 法 作为 equalLs ( ) 的 配套 方法 ， 也 需要 一 起 
重 写 ， 人 否则 会 导致 HashMap、HashSet 等 hash 相 关 的 系统 类 无 法 正常 工作 。toString () 方 法 
用 于 提供 更 清晰 的 输入 日 志 ， 否则 一 个 数据 类 默认 打印 出 来 的 就 是 一 行内 存 地 址 。 


这 里 我 们 新 构建 一 个 手机 数据 类 ， 字 段 就 简单 一 点 ， 只 有 品牌 和 价格 这 两 个 字段 。 如 果 使 用 
Java 来 实现 这 样 一 个 数据 类 ， 代 码 就 需要 这 样 写 : 


public class Cellphone { 
String brand; 
double price; 


public Cellphone(String brand, double price) { 
this.brand = brand; 
this.price = price; 


@Override 
public boolean equaLs(0bject obj) { 
if (obj instanceof Cellphone) { 
Cellphone other = (Cellphone) obj; 
return other.brand.equals(brand) &A& other.price == price; 


return false; 


} 


@Override 
public int hashCode() { 
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return brand.hashCode() + (int) price; 


@Override 
public String toString() { 
return "Cellphone(brand=" + brand + ", price=" + price + ")"; 


} 


看 上 去 挺 复杂 的 吧 ? 关键 是 这 些 代 码 还 是 一 些 没 有 实际 逻辑 意义 的 代码 ， 只 是 为 了 让 它 拥有 数 
据 类 的 功能 而 已 。 而 同样 的 功能 使 用 Kotlin 来 实现 就 会 变 得 极其 简单 ， 右 击 
com.example.helloworld 包 New 一 Kotlin File/Class , 在 弹出 的 对 话 框 中 输 

入 “Cellphone”， 创建 类 型 选择 “Class”"。 然 后 在 创建 的 类 中 编写 如 下 代码 : 


data class Cellphone(val brand: String, val price: Double) 


你 没 看 错 ， 只 需要 一 行 代码 就 可 以 实现 了 ! 神奇 的 地 方 就 在 于 data 这 个 关键 字 ， 当 在 一 个 类 前 
面 声 明了 data 关 键 字 时 ， 就 表明 你 希望 这 个 类 是 一 个 数据 类 ，Kotlin 会 根据 主 构造 水 数 中 的 参 
数 帮 你 将 equals ()、hashCode()、toString() 等 固定 且 无 实际 逻辑 意义 的 方法 自动 生成 ， 
从 而 大 大 减少 了 开发 的 工作 量 。 


另外 ， 当 一 个 类 中 没有 任何 代码 时 ， 还 可 以 将 尾部 的 大 括号 省 略 。 
下 面 我 们 来 测试 一 下 这 个 数据 类 ， 在 main( ) 函 数 中 编写 如 下 代码 : 


fun main() { 
val cellphonel = Cellphone("Samsung", 1299.99) 
val cellphone2 = Cellphone("Samsung", 1299.99) 
println(cellphonel) 
println("cellphonel equals ceLLphone2 " + (cellphonel == cellphone2)) 


这 里 我 们 创建 了 两 个 CeLLphone 对 象 ， 首 先 直 接 将 第 一 个 对 象 打印 出 来 ， 然 后 判断 这 两 个 对 象 
是 否 相等 。 运 行 一 下 程序 ， 结果 如 图 2.22 所 示 。 


Run: 在 com.example.helloworld.LearnKotlinKt 

过 "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Cellphone(brand=Samsung, price=1299.99) 

cellphonel equals cellphone2 true 


Process finished with exit code 0 
= 


图 2.22 ”测试 CeLLphone 数 据 类 的 结果 


很 明显 ，CeLtLphone 数 据 类 已 经 正常 工作 了 。 而 如 果 CeLLphone 类 前 面 没 有 data 这 个 关键 
字 ,得 到 的 会 是 截然 不 同 的 结果 。 如 果 感 兴趣 的 话 ， 你 可 以 自己 动手 尝试 一 下 。 


掌握 了 数据 类 的 使 用 技巧 之 后 ， 接 下 来 我 们 再 来 看 另外 一 个 Kotlin 中 特有 的 功能 一 一 单 例 类 。 


想必 你 一 定 听 说 过 单 例 模式 吧 ， 这 是 最 常用 、 最 基础 的 设计 模式 之 一 ， 它 可 以 用 于 避免 创建 重 
复 的 对 象 。 比 如 我 们 希望 某 个 类 在 全 局 最 多 只 能 拥有 一 个 实例 ， 这 时 就 可 以 使 用 单 例 模式 。 当 
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然 单 例 模式 也 有 很 多 种 写法 ， 这 里 就 演示 一 种 最 常见 的 java 写 法 吧 : 


public class Singleton { 
private static Singleton instance; 


private Singleton() {} 
public synchronized static Singleton getInstance() { 
if (instance == null) { 


instance = new Singleton(); 
} 


return instance; 


} 


public void singletonTest() { 
System.out.println("singletonTest is called."); 


} 


这 段 代 码 其 实 很 好 理解 ， 首先 为 了 禁止 外 部 创建 5ijngleton 的 实例 ,我们 需要 用 private 关 键 
字 将 Singleton 的 构造 涵 数 私有 化 ,然后 给 外 部 提供 了 一 个 getInstance( ) 静 态 方 法 用 于 获 
取 Singleton 的 实例 。 在 getInstance() 方 法 中 ， 我们 判断 如 果 当 前 缓存 的 Singleton 实 例 
为 null ,就 创建 一 个 新 的 实例 ， 否 则 直接 返回 缓存 的 实例 即 可 ， 这 就 是 单 例 模 式 的 工作 机 制 |。 


而 如 果 我 们 想 调用 单 例 类 中 的 方法 ,也 很 简单 ， 比 如 想 调 用 上 述 的 singletonTest() 方 法 ， 
就 可 以 这 样 写 : 


Singleton singleton = Singleton.getInstance(); 
singleton.singletonTest(); 


虽然 Jjava 中 的 单 例 实现 并 不 复杂 ， 但 是 Kotlin 明 显 做 得 更 好 ， 它 同样 是 将 一 些 固 定 的 、 重 复 的 逻 
辑 实现 隐藏 了 起 来 ， 只 骏 露 给 我 们 最 简单 方便 的 用 法 。 


在 Kotlin 中 创建 一 个 单 例 类 的 方式 极其 简单 ， 只 需要 将 cLass 关 键 字 改 成 object 关 键 字 即 可 。 
现在 我 们 尝试 创建 一 个 Kotlin 版 的 Sijngleton 单 例 类 , 右 击 com.example.helloworld 包 

一 New 一 Kotlin File/Class ，, 在 弹出 的 对 话 框 中 输入 “Singleton”, 创建 类 型 选择 “Object”, 点 
击 “OK" 完 成 创建 ， 初 始 代 码 如 下 所 示 : 


object Singleton { 
4 


现在 Singleton 就 已 经 是 一 个 单 例 类 了 ， 我们 可 以 直接 在 这 个 类 中 编写 需要 的 函数 ， 比 如 加 入 
一 个 SingLetonTest ( ) 基数 : 


object Singleton { 
fun singletonTest() { 


println("singletonTest is called.") 


可 以 看 到 ， 在 Kotlin 中 我 们 不 需要 私有 化 构造 函数 ， 也 不 需要 提供 getInstance( ) 这 样 的 静态 
方法 ,内 需要 把 cLass 关 键 字 改 成 object 关 键 字 , 一 个 单 例 类 就 创建 完成 了 。 而 调用 单 例 类 中 
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的 函数 也 很 简单 ， 比 较 类 似 于 java 中 静态 方法 的 调用 方式 : 


Singleton.singletonTest() 


这 种 写法 虽然 看 上 去 像 是 静态 方法 的 调用 ,但 其 实 Kotlin 在 背后 自动 帮 我 们 创建 了 一 个 
Singleton 类 的 实例 ， 并 且 保 证 全 局 只 会 存在 一 个 Singleton 实 例 。 


这 样 我 们 就 将 Kotlin 面 向 对 象 编程 最 主要 的 知识 掌握 了 ， 这 也 是 非常 充实 的 一 节 内 容 ， 希望 你 能 
好 好 掌握 和 消化 。 要 知道 ， 你 往 后 的 编程 工作 基本 上 是 建立 在 面向 对 象 编程 的 基础 之 上 的 。 
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2.6 Lambda 编程 


可 能 很 多 Java 程 序 员 对 于 Lambda 编 程 还 比较 陌生 ,但 其 实 这 并 不 是 什么 新 鲜 的 技术 。 许 多 现 

代 高 级 编程 语言 在 很 早 之 前 就 开始 支持 Lambda 编 程 了 ， 但 是 java 却 直到 JDK 1.8 之 后 才 加 入 了 
Lambda 编 程 的 语法 支持 。 因 此 ， 大 量 早期 开发 的 ava 和 Android 程 序 其 实 并 未 使 用 Lambda 

编程 的 特性 。 


而 Kotlin 从 第 一 个 版 本 开始 就 支持 了 Lambda 编 程 ， 并 且 Kotlin 中 的 Lambda 功 能 极为 强大 , 我 
甚至 认为 Lambda 才 是 Kotlin 的 灵魂 所 在 。 不 过 ,本章 只 是 Kotlin 的 入 门 章节 ,我 不 可 能 在 这 短 
短 一 节 里 就 将 Lambda 的 方方面面 全 部 覆盖 。 因 此 ， 这 一 节 我 们 只 学 习 一 些 Lambda 编 程 的 基 
础 知识 ， 而 像 高 阶 函 数 、DSL 等 高 级 Lambda 技 巧 ， 我 们 会 在 本 书 的 后 续 章节 慢 慢 学 习 。 


2.6.1 集合 的 创建 与 遍历 


集合 的 函数 式 API 是 用 来 入 门 Lambda 编 程 的 绝 佳 示 例 ， 不 过 在 此 之 前 ， 我 们 得 先 学 习 创建 集合 
的 方式 才 行 。 

传统 意义 上 的 集合 主要 就 是 List 和 Set， 再 广泛 一 点 的 话 ， 像 Map 这 样 的 键 值 对 数据 结构 也 可 
以 包含 进来 。List、Set 和 Map 在 java 中 都 是 接口 ，LiSst 的 主要 实现 类 是 ArrayList 和 
LinkedList ,Set 的 主要 实现 类 是 HashSet , Map 的 主要 实现 类 是 HashMap ,熟悉 Java 的 人 
对 这 些 集合 的 实现 类 一 定 不 会 陌生 。 


现在 我 们 提出 一 个 需求 ， 创 建 一 个 包含 许多 水 果 名 称 的 集合 。 如 果 是 在 java 中 你 会 怎么 实现 ? 
可 能 你 首先 会 创建 一 个 ArrayList 的 实例 ， 然 后 将 水 果 的 名 称 一 个 个 添加 到 集合 中 。 当 然 ， 在 
Kotlin 中 也 可 以 这 么 做 : 

val list = ArrayList<String>() 


list.add("Apple") 
.add ("Banana") 


.add("Orange") 
.add ("Pear") 
.add("Grape") 


但 是 这 种 初始 化 集合 的 方式 比较 烦琐 ， 为 此 Kotlin 专 门 提供 了 一 个 内 置 的 ListOf ( ) 函数 来 简化 
初始 化 集合 的 写法 ， 如 下 所 示 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 


可 以 看 到 ， 这 里 仅 用 一 行 代码 就 完成 了 集合 的 初始 化 操作 。 


还 记得 我 们 在 学 习 循 环 语句 时 提 到 过 的 吗 ? for- in 循环 不 仅 可 以 用 来 遍历 区 间 ， 还 可 以 用 来 饥 
历 集合 。 现 在 我 们 就 尝试 一 下 使 用 for- in 循环 来 遍历 这 个 水 果 集 合 ， 在 main ( ) 咀 数 中 编写 如 
下 代码 : 


fun main() { 
val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
for (fruit in list) { 
println(fruit) 
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} 
} 


运行 一 下 代码 ， 结 果 如 图 2.23 所 示 。 


Run: 下 com.example.helloworld.LearnKotlinKt 

"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Apple 

Banana 

Orange 

Pear 

Grape 


| 


Process finished with exit code 0 


le YI 


图 2.23 ”对 集合 进行 遍历 


不 过 需要 注意 的 是 ，Listof ( ) 函 数 创建 的 是 一 个 不 可 变 的 集合 。 你 也 许 不 太 能 理解 什么 叫 作 不 
可 变 的 集合 ， 因 为 在 java 中 这 个 概念 不 太 常见 。 不 可 变 的 集合 指 的 就 是 该 集合 只 能 用 于 读 取 ， 
我 们 无 法 对 集合 进行 添加 、 修 改 或 删除 操作 。 


至 于 这 么 设计 的 理由 ， 和 vat 关 键 字 、 类 默认 不 可 继承 的 设计 初衷 是 类 似 的 ， 可 见 Kotlin 在 不 可 
变性 方面 控制 得 极其 严格 。 那 如 果 我 们 确实 需要 创建 一 个 可 变 的 集合 呢 ? 也 很 简单 ， 使 用 
mutabLeListof () 纹 数 就 可 以 了 ， 示例 如 下 : 


fun main() { 
val list = mutableList0f("Apple", "Banana", "Orange", "Pear", "Grape") 
list.add("Watermelon") 
for (fruit in list) { 
println(fruit) 


} 


这 里 先 使 用 mutabtLeListoOf () 函数 创建 一 个 可 变 的 集合 ， 然 后 向 集合 中 添加 了 一 个 新 的 水 
果 ， 最 后 再 使 用 for- in 循环 对 集合 进行 遍历 。 现 在 重新 运行 一 下 代码 ， 结 果 如 图 2.24 所 示 。 


Run: 二 com.example.helloworld.LearnKotlinKt 
"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
le Apple 
Banana 
Orange 
Pear 
Grape 
Watermelon 


qi le YI 


Process finished with exit code 0 
图 2.24 ”对 可 变 集合 进行 遍历 
可 以 看 到 ， 新 添加 到 集合 中 的 水 果 已 经 被 成 功 打印 出 来 了 。 


前 面 我 们 介绍 的 都 是 List 集 合 的 用 法 ， 实 际 上 Set 集 合 的 用 法 几乎 与 此 一 模 一 样 ， 只 是 将 创建 
集合 的 方式 换 成 了 set0Of() 和 mutabtLeSet0f ( ) 函 数 而 已 。 大 致 代 码 如 下 : 


val set = set0f("Apple", "Banana", "Orange", "Pear", "Grape" ) 
for (fruit in set) { 
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printLn(fruit) 


需要 注意 ，Set 集 合 中 是 不 可 以 存放 重复 元 素 的 ， 如 果 存放 了 多 个 相同 的 元 素 ， 只 会 保留 其 中 一 
份 ， 这 是 和 List 集 合 最 大 的 不 同 之 处 。 当 然 这 部 分 知识 属于 数据 结构 相关 的 内 容 ， 这 里 就 不 展 
开 讨 论 了 。 


最 后 再 来 看 一 下 Map 集 合 的 用 法 。Map 是 一 种 键 值 对 形式 的 数据 结构 ， 因 此 在 用 法 上 和 List、 
Set 集 合 有 较 大 的 不 同 。 传 统 的 Map 用 法 是 先 创 建 一 个 HashMap 的 实例 ， 然 后 将 一 个 个 键 值 对 数 
据 添加 到 Map 中 。 比 如 这 里 我 们 给 每 种 水 果 设 置 一 个 对 应 的 编号 ， 就 可 以 这 样 写 : 


val map = HashMap<String, Int>() 
map.put("Apple", 1) 
map.put("Banana", 2) 


map.put 
map.put 


'Pear", 4) 
'Grape", 5) 


( 
人 
map,put("0range"，3) 
人 
人 


我 之 所 以 先 用 这 种 写法 ， 是 因为 这 种 写法 和 java 语 法 是 最 相似 的 ， 因 此 可 能 最 好 理解 。 但 其 实 
在 Kotlin 中 并 不 建议 使 用 put ( ) 和 get ( ) 方 法 来 对 Map 进 行 添加 和 读 取 数 据 操作 ， 而 是 更 加 推荐 
使 用 一 种 类 似 于 数组 下 标的 语法 结构 ， 比 如 向 Map 中 添加 一 条 数据 就 可 以 这 么 写 : 

map["Apple"] = 1 

而 从 Map 中 读 取 一 条 数据 就 可 以 这 么 写 : 


因此 ， 上述 代 码 经 过 优化 过 后 就 可 以 变 成 如 下 形式 : 


val map = HashMap<String, Int>() 


] 
map["Orange"] 
map["Pear"] = 
map["Grape"] = 5 


当然 ， 这 仍然 不 是 最 简便 的 写法 ， 因 为 Kotlin 宫 无 疑问 地 提供 了 一 对 map0Of ( ) 和 
mutableMap0f ( ) 函数 来 继续 简化 Map 的 用 法 。 在 mapof ( ) 函 数 中 ， 我们 可 以 直接 传 入 初始 化 
的 键 值 对 组 合 来 完成 对 Map 集 合 的 创建 : 


val map = map0f("Apple" to 1, "Banana" to 2, "Orange" to 3, "Pear" to 4, "Grape" to 5) 


这 里 的 键 值 对 组 合 看 上 去 好 像 是 使 用 to 这 个 关键 字 来 进行 关联 的 ， 但 其 实 to 并 不 是 关键 字 , 而 
是 一 个 infix 函 数 ， 我 们 会 在 本 书 第 9 章 的 Kotlin 课 堂 中 深入 探究 infix 范 数 的 相关 内 容 。 


最 后 再 来 看 一 下 如 何人 遍历 Map 集 合 中 的 数据 吧 ， 其 实 使 用 的 仍然 是 for- in 循环 。 在 main( ) 函 
数 中 编写 如 下 代码 : 


fun main() { 
val map = mapO0f("Apple" to 1, "Banana" to 2, "Orange" to 3, "Pear" to 4, "Grape" to 5) 
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for ((fruit, number) in map) { 
println("fruit is " + fruit + ", number is " + number) 


这 段 代 码 主要 的 区 别 在 于 ,在 for-in 循 环 中 ,我 们 将 Map 的 键 值 对 变量 一 起 声明 到 了 一 对 括号 
里 面 ， 这样 当 进行 循环 遍历 时 ， 每 次 遍历 的 结果 就 会 赋值 给 这 两 个 键 值 对 变量 ， 最 后 将 它们 的 
值 打印 出 来 。 重 新 运行 一 下 代码 ， 结 果 如 图 2.25 所 示 。 


Run: 于 com.example.helloworld.LearnKotlinKt 

"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
fruit is Apple, number is 1 

fruit is Banana, number is 2 


Pp 


fruit is Orange, number is 3 
fruit is Pear, number is 4 
fruit is Grape, number is 5 


Process finished with exit code 0 


le YI 


图 2.25 遍历 Map 中 的 数据 


好 了 “， 关 于 集合 的 创建 与 遍历 就 学 到 这 里 ， 接 下 来 我 们 开始 学 习 集合 的 函数 式 API ,从 而 正式 入 
门 Lambda 编 程 。 


2.6.2 集合 的 函数 式 API 


集合 的 函数 式 API 有 很 多 个 ， 这 里 我 并 不 打算 带 你 涉猎 所 有 肯 数 式 API 的 用 法 ， 而 是 重点 学 习 肯 
数 式 API 的 语法 结构 ， 也 就 是 Lambda 表 达 式 的 语法 结构 。 


首先 我 们 来 思考 一 个 需求 ， 如 何在 一 个 水 果 集 合 里 面 找到 单词 最 长 的 那个 水 果 ? 当然 这 个 需求 
很 简单 ， 也 有 很 多 种 写法 ， 你 可 能 会 很 自然 地 写 出 如 下 代码 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape", "Watermelon") 
Var maxLengthFruit = "" 
for (fruit in list) { 
if (fruit.length > maxLengthFruit.length) { 
maxLengthFruit = fruit 


println("max length fruit is " + maxLengthFruit) 


这 上段 代码 很 简洁 ， 思 路 也 很 清晰 ， 可 以 说 是 一 段 相当 不 错 的 代码 了 。 但 是 如 果 我 们 使 用 集合 的 
盟 数 式 API ,就 可 以 让 这 个 功能 变 得 更 加 容易 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape", "Watermelon") 
val maxLengthFruit = list.maxBy { it.length } 
println("max length fruit is " + maxLengthFruit) 


上 述 代 码 使 用 的 就 是 肖 数 式 API 的 用 法 ， 只 用 一 行 代码 就 能 找到 集合 中 单词 最 长 的 那个 水 果 。 或 
许 你 现在 理解 这 段 代码 还 比较 吃力 ， 那 是 因为 我 们 还 没有 开始 学 习 Lambda 表 达 式 的 语法 结 
构 ， 等 学 完 之 后 再 来 重新 看 这 段 代 码 时 ， 你 就 会 觉得 非常 简单 易 懂 了 。 
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首先 来 看 一 下 Lambda 的 定义 ， 如 果 用 最 直 白 的 语言 来 阐述 的 话 , Lambda 就 是 一 小 段 可 以 作 
为 参数 传递 的 代码 。 从 定义 上 看 ,这 个 功能 就 很 历 害 了 ， 因 为 正常 情况 下 ， 我 们 向 某 个 函数 传 
参 时 只 能 传 入 变量 ， 而 借助 Lambda 却 允许 传 入 一 小 段 代码 。 这 里 两 次 使 用 了 ”一 小 段 代 码 " 这 
种 描述 ， 那 么 到 底 多 少 代码 才 算 一 小 段 代 码 呢 ? Kotlin 对 此 并 没有 进行 限制 ， 但 是 通常 不 建议 在 
Lambda 表 达 式 中 编写 太 长 的 代码 ， 否 则 可 能 会 影响 代码 的 可 读 性 。 


接着 我 们 来 看 一 下 Lambda 表 达 式 的 语法 结构 : 


{参数 名 1 : 参数 类 型 ， 参 数 名 2: 参数 类 型 -> 函数 体 } 


这 是 Lambda 表 达 式 最 完整 的 语法 结构 定义 。 首 先 最 外 层 是 一 对 大 括号 ， 如 果 有 参数 传 入 到 
Lambda 表 达 式 中 的 话 ， 我 们 还 需要 声明 参数 列表 ， 参数 列表 的 结尾 使 用 一 个 - > 符号 ， 表 示 参 
数列 表 的 结束 以 及 冰 数 体 的 开始 ， 肯 数 体 中 可 以 编写 任意 行 代码 (虽然 不 建议 编写 太 长 的 代 
码 ) ， 并 且 最 后 一 行 代码 会 自动 作为 Lambda 表 达 式 的 返回 值 。 


当然 ， 在 很 多 情况 下 ， 我们 并 不 需要 使 用 Lambda 表 达 式 完整 的 语法 结构 ， 而 是 有 很 多 种 简化 
的 写法 。 但 是 简化 版 的 写法 对 于 初学 者 而 言 更 难 理解 ， 因 此 这 里 我 准备 使 用 一 步 步 推导 演化 的 
方式 ， 向 你 展示 这 些 简化 版 的 写法 是 从 何 而 来 的 ， 这 样 你 就 能 对 Lambda 表 达 式 的 语法 结构 理 
解 得 更 加 深刻 了 。 那 么 接 下 来 我 们 就 由 繁 入 简 开始 吧 。 


还 是 回 到 刚才 找 出 最 长 单词 水 果 的 需求 ， 前 面 使 用 的 闻 数 式 API 的 语法 结构 看 上 去 好 像 很 特殊 ， 
但 其 实 maxBy 就 是 一 个 普通 的 函数 而 已 ， 只 不 过 它 接收 的 是 一 个 Lambda 类 型 的 参数 ， 并 且 会 
在 遍历 集合 时 将 每 次 遍历 的 值 作 为 参数 传递 给 Lambda 表 达 式 。maxBy 函 数 的 工作 原理 是 根据 
我 们 传 入 的 条 件 来 遍历 集合 ， 从 而 找到 该 条 件 下 的 最 大 值 ， 比 如 说 想 要 找到 单词 最 长 的 水 果 ， 

那么 条 件 自 然 就 应 该 是 单词 的 长 度 了 。 


理解 了 maxBy 浮 数 的 工作 原理 之 后 ， 我们 就 可 以 开始 套用 刚才 学 习 的 Lambda 表 达 式 的 语法 结 
构 ,并 将 它 传 入 到 maxBy 函 数 中 了 ,如 下 所 示 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape", "Watermelon") 


val lambda = { fruit: String -> fruit.length } 
val maxLengthFruit = list.maxBy(lambda) 


可 以 看 到 ,maxBy 范 数 实质 上 就 是 接收 了 一 个 Lambda 参 数 而 已 ， 并 且 这 个 Lambda 参 数 是 完 
全 按照 刚才 学 习 的 表达 式 的 语法 结构 来 定义 的 ， 因 此 这 段 代 码 应 该 算是 比较 好 懂 的 。 


这 种 写法 虽然 可 以 正常 工作 ,但 是 比较 思 呆 ， 可 简化 的 点 也 非常 多 ,下面 我 们 就 开始 对 这 上段 代 
码 一 步 步 进 行 简化 。 


首先 ， 我 们 不 需要 专门 定义 一 个 Lambda 变 量 ， 而 是 可 以 直接 将 Lambda 表 达 式 传 入 maxBy 范 数 
当中 ， 因 此 第 一 步 简化 如 下 所 示 : 


val maxLengthFruit = list.maxBy({ fruit: String -> fruit.Length }) 


然后 Kotlin 规 定 ， 当 Lambda 参 数 是 纯 数 的 最 后 一 个 参数 时 , 可 以 将 Lambda 表 达 式 移 到 函数 括 
号 的 外 面 ， 如 下 所 示 : 
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val maxLengthFruit = list.maxBy() { fruit: String -> fruit.length } 


接 下 来 ， 如 果 Lambda 参 数 是 冰 数 的 唯一 一 个 参数 的 话 ， 还 可 以 将 水 数 的 括号 省 略 : 


val maxLengthFruit = list.maxBy { fruit: String -> fruit.Length } 


这 样 代码 看 起 来 就 变 得 清爽 多 了 吧 ? 但 是 我 们 还 可 以 继续 进行 简化 。 由 于 Kotlin 拥 有 出 色 的 类 型 
推导 机 制 ，Lambda 表 达 式 中 的 参数 列表 其 实在 大 多 数 情况 下 不 必 声 明 参 数 类 型 ， 因 此 代码 可 
以 进一步 简化 成 : 


val maxLengthFruit = list.maxBy { fruit -> fruit.length } 


最 后 ， 当 Lambda 表 达 式 的 参数 列表 中 只 有 一 个 参数 时 ， 也 不 必 声 明 参 数 名 ， 而 是 可 以 使 用 it 
关键 子 来 代 蔡 ， 那么 代码 就 变 成 了 : 


val maxLengthFruit = list.maxBy { it,Length } 


怎么 样 ? 通过 一 步 步 推导 的 方式 ， 我 们 就 得 到 了 和 一 开始 那 段 函数 式 API 一 模 一 样 的 与 法， 是 不 
是 现在 理解 起 来 就 非常 轻松 了 呢 ? 


正如 本 小 节 开头 所 说 的 ， 这 里 我 们 重点 学 习 的 是 函数 式 API 的 语法 结构 ， 理 解 了 语法 结构 之 后 ， 
集合 中 的 各 种 其 他 函数 式 API 都 是 可 以 快速 掌握 的 。 


接 下 来 我 们 就 再 来 学 习 几 个 集合 中 比较 常用 的 函数 式 API， 相 信 这 些 对 于 现在 的 你 来 说 ， 应 该 是 
没有 什么 困难 的 。 


集合 中 的 map 函 数 是 最 常用 的 一 种 函数 式 API， 它 用 于 将 集合 中 的 每 个 元 素 都 映射 成 一 个 另外 的 
值 , 映射 的 规则 在 Lambda 表 达 式 中 指定 ， 最 终生 成 一 个 新 的 集合 。 比 如 ， 这 里 我 们 希望 让 所 
有 的 水 果 名 都 变 成 大 写 模 式 ， 就 可 以 这 样 写 : 


fun main() { 
val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape", "Watermelon") 
val newList = list.map { it.toUpperCase() } 
for (fruit in newList) { 
println(fruit) 


} 


可 以 看 到 ,我 们 在 map 少 数 的 Lambda 表 达 式 中 指定 将 单词 转换 成 了 大 写 模 式 ， 然 后 遍历 这 个 新 
生成 的 集合 。 运 行 一 下 代码 ， 结 果 如 图 2.26 所 示 。 


Run: 三 com.example.helloworld.LearnKotlinKt 


> "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
APPLE 


GRAPE 
WATERMELON 


YI 


Process finished with exit code 0 
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图 2.26 将 水 果 名 都 转换 成 大 写 模 式 


map 函 数 的 功能 非常 强大 ， 它 可 以 按照 我 们 的 需求 对 集合 中 的 元 素 进 行 任意 的 映射 转换 ， 上 面 只 
是 一 个 简单 的 示例 而 已 。 除 此 之 外 ， 你 还 可 以 将 水 果 名 全 部 转换 成 小 写 ， 或 者 是 只 取 单 词 的 首 
字母 ， 甚 至 是 转换 成 单词 长 度 这 样 一 个 数字 集合 ， 只 要 在 Lambda 表 示 式 中 编写 你 需要 的 逻辑 
即 可 。 


接 下 来 我 们 再 来 学 习 另 外 一 个 比较 常用 的 函数 式 API 一 一 fiLter 汶 数 。 顾 名 思 义 ，fiLter 苑 数 
是 用 来 过 滤 集 合 中 的 数据 的 ， 它 可 以 单独 使 用 ,也 可 以 配合 刚才 的 map 函 数 一 起 使 用 。 


比如 我 们 只 想 保留 5 个 字母 以 内 的 水 果 ， 就 可 以 借助 fiLter 函 数 来 实现 ， 代 码 如 下 所 示 : 


fun main() { 
val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape", "Watermelon") 
val newList = list.filter { it.length <= 5 } 
.map { it.toUpperCase() } 
for (fruit in newList) { 
println(fruit) 


} 


可 以 看 到 ， 这 里 同时 使 用 了 fitLter 和 map 上 师 数 ， 并 通过 Lambda 表 示 式 将 水 果 单词 长 度 限制 在 
5 个 字母 以 内 。 重 新 运行 一 下 代码 ， 结 果 如 图 2.27 所 示 。 


Run: ~ com.example.helloworld.LearnKotlinKt 

p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
APPLE 

PEAR 

GRAPE 


Process finished with exit code 0 
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图 2.27 对 水 果 单 词 长 度 进行 过 渡 


另外 值得 一 提 的 是 ， 上 述 代码 中 我 们 是 先 调 用 了 fitter 上 函数 再 调用 map 上 函数 。 如 果 你 改 成 先 调 
用 map 少 数 再 调用 filter 少 数 ， 也 能 实现 同样 的 效果 ,但 是 效率 就 会 差 很 多 ， 因 为 这 样 相当 于 
要 对 集合 中 所 有 的 元 素 都 进行 一 次 映射 转换 后 再 进行 过 滤 ， 这 是 完全 不 必要 的 。 而 先进 行 过 渡 
操作 ， 再 对 过 滤 后 的 元 素 进 行 映射 转换 ， 就 会 明显 高 效 得 多 。 

接 下 来 我 们 继续 学 习 两 个 比较 常用 的 函数 式 API 一 一 any 和 alL1L 函 数 。 其 中 any 函 数 用 于 判断 集 
合 中 是 否 至 少 存在 一 个 元 素 满足 指定 条 件 ，aL1L 函 数 用 于 判断 集合 中 是 否 所 有 元 素 都 满足 指定 条 
件 。 由 于 这 两 个 亢 数 都 很 好 理解 ， 我 们 就 直接 通过 代码 示例 学 习 了 : 


fun main() { 
val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape", "Watermelon") 
val anyResult = list.any { it,Length <= 5 } 
val allResult = list.all { it.Length <= 5 } 
println("anyResult is " + anyResult + ", allResult is " + allResult) 
} 


这 里 还 是 在 Lambda 表 达 式 中 将 条 件 设置 为 5 个 字母 以 内 的 单词 ， 那 么 any 函 数 就 表示 集合 中 是 
否 存在 5 个 字母 以 内 的 单词 ， 而 atLL 函 数 就 表示 集合 中 是 否 所 有 单词 都 在 5 个 字母 以 内 。 现 在 重 
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新 运行 一 下 代码 ， 结 果 如 图 2.28 所 示 。 


Run: com.example.helloworld.LearnKotlinKt 
p "/Applications/Android Studio.app/Contents/ijre/jdk/Contents/Home/bin/java”" ... 
anyResult is true, allResult is false 


Process finished with exit code 0 


lt Yl 


图 2.28 any 和 aLL 函 数 的 执行 结果 


这 样 我 们 就 将 Lambda 表 达 式 的 语法 结构 和 几 个 常用 的 函数 式 API 的 用 法 都 学 习 完 了 ， 虽 然 集合 
中 还 有 许多 其 他 范 数 式 API ,但 是 只 要 掌握 了 基本 的 语法 规则 ， 其 他 冰 数 式 API 的 用 法 只 要 看 一 
看 文档 就 能 掌握 了 ， 相 信 这 对 你 来 说 并 不 是 难事 。 


2.6.3 ”java 也 数 式 API1 的 使 用 


现在 我 们 已 经 学 习 了 Kotlin 中 函数 式 API 的 用 法 ， 但 实际 上 在 Kotlin 中 调用 java 方 法 时 也 可 以 使 
用 也 数 式 AP1 ,只 不 过 这 是 有 一 定 条 件 限制 的 。 具 体 来 讲 ， 如 果 我 们 在 Kotlin 代 码 中 调用 了 一 个 
java 方 法， 并 且 该 方法 接收 一 个 java 单 抽象 方法 接口 参数 ， 就 可 以 使 用 函数 式 API。java 单 抽象 
方法 接口 指 的 是 接口 中 只 有 一 个 待 实现 方法 ， 如果 接口 中 有 多 个 待 实现 方法 ， 则 无 法 使 用 泥 数 
式 APl。 


如 果 你 觉得 上 面 的 描述 有 些 模糊 的 话 ， 没 关系 ， 下 面 我 们 通过 一 个 具体 的 例子 来 学 习 一 下 ， 你 
就 能 明白 了 。Java 原 生 APl 中 有 一 个 最 为 常见 的 单 抽象 方法 接口 一 一 RunnabLe 接 口 。 这 个 接口 
中 只 有 一 个 待 实现 的 run( ) 方 法 ,定义 如 下 : 


public interface Runnable { 
void run(); 
} 


根据 前 面 的 讲解 ， 对 于 任何 一 个 java 方 法， 只 要 它 接 收 RunnabLe 参 数 ， 就 可 以 使 用 函数 式 
APl。 那 么 什么 Java 方 法 接收 了 Runnable 参 数 呢 ? 这 就 有 很 多 了 ,不 过 RunnabtLe 接 口 主要 还 
是 结合 线程 来 一 起 使 用 的 ， 因 此 这 里 我 们 就 通过 Java 的 线程 类 Thread 来 学 习 一 下 。 


Thread 类 的 构造 方法 中 接收 了 一 个 Runnable 参 数 ， 我 们 可 以 使 用 如 下 Java 代 码 创 建 并 执行 一 
个 子 线程 : 


new Thread(new Runnable() { 
@Override 
public void run() { 


System.out.println("Thread is running"); 


} 
}).start(); 


注意 ， 这 里 使 用 了 匿名 类 的 写法 ,我 们 创建 了 一 个 Runnable 接 口 的 匿名 类 实例 ， 并 将 它 传 给 了 
Thread 类 的 构造 方法 ， 最 后 调用 Thread 类 的 start( ) 方 法 执行 这 个 线程 。 


而 如 果 直 接 将 这 段 代 码 翻 译 成 Kotlin 版 本 ， 写 法 将 如 下 所 示 : 
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Thread(object : Runnable { 
override fun run() { 
println("Thread is running") 


} 
}).start() 


Kotlin 中 攻 名 类 的 写法 和 Java 有 一 点 区 别 ,由 于 Kotlin 完 全 舍弃 了 new 关 键 字 ， 因 此 创建 匿名 类 
实例 的 时 候 就 不 能 再 使 用 new 了 ， 而 是 改 用 了 object 关 键 字 。 这 种 写法 虽然 算 不 上 复杂 ,但 是 
相 比 于 Java 的 攻 名 类 写法 ， 并 没有 什么 简化 之 处 ，。 


但 是 别 忘 了 ， 目前 Thread 类 的 构造 方法 是 符合 Jjava 也 数 式 API 的 使 用 条 件 的 ， 下 面 我 们 就 看 看 
如 何 对 代码 进行 精简 ,如 下 所 示 : 
Thread(Runnable { 


println("Thread is running") 
}).start() 


这 段 代 码 明 显 简化 了 很 多 ， 既 可 以 实现 同样 的 功能 ， 又 不 会 造成 任何 歧义 。 因 为 RunnabtLe 类 中 
只 有 一 个 待 实现 方法 ,即使 这 里 没有 显 式 地 重 写 run ( ) 方 法 ，Kotlin 也 能 自动 明白 RunnabtLe 后 
面 的 Lambda 表 达 式 就 是 要 在 run ( ) 方 法 中 实现 的 内 容 。 


另外 ,如 果 一 个 java 方法 的 参数 列表 中 有 且 仪 有 一 个 java 单 抽象 方法 接口 参数 ， 我 们 还 可 以 将 
接口 名 进行 省 略 ， 这 样 代 码 就 变 得 更 加 精简 了 : 


Thread ({ 
printLn("Thread is running") 
}).start() 


不 过 到 这 里 还 没有 结束 ， 和 之 前 Kotlin 中 消 数 式 API 的 用 法 类 似 ， 当 Lambda 表 达 式 是 方法 的 最 
后 一 个 参数 时 ， 可 以 将 Lambda 表 达 式 移 到 方法 括号 的 外 面 。 同 时 ， 如果 Lambda 表 达 式 还 是 
方法 的 唯一 一 个 参数 ， 还 可 以 将 方法 的 括号 省 略 ， 最 终 简化 结果 如 下 : 

Thread { 


println("Thread is running") 
}.start() 


如 果 你 将 上 述 代码 写 肥 jmain ( ) 消 数 中 并 执行 ， 就 会 得 人 如 图 2.29 所 示 的 结果 。 


Run: ~ com.example.helloworld.LearnKotlinKt 
p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Thread is running 


Process finished with exit code 0 


le | dl 


图 2.29 java 函数 式 API 的 运行 结果 

或 许 你 会 觉得 ， 既 然 本 书 中 所 有 的 代码 都 是 使 用 Kotlin 编 写 的 ， 这 种 java 函 数 式 API 应 该 并 不 党 
用 吧 ?其 实 并 不 是 这 样 的 ， 因 为 我 们 后 面 要 经 常 打交道 的 Android SDK 还 是 使 用 Java 语 言 编 写 
的 ， 当 我 们 在 Kotlin 中 调用 这 些 SDK 接 口 时 ， 就 很 可 能 会 用 到 这 种 java 函 数 式 API 的 写法 。 
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举 个 例子 ,Android 中 有 一 个 极为 常用 的 点 击 事件 接口 OnCLickListener ,其 定义 如 下 : 


public interface OnClickListener { 
void onClick(View v); 


可 以 看 到 ， 这 又 是 一 个 单 抽象 方法 接口 。 假 设 现在 我 们 拥有 一 个 按钮 button 的 实例 ， 然 后 使 用 
Java 代 码 去 注册 这 个 按钮 的 点 击 事件 ， 需 要 这 么 写 : 


button.setOnClickListener(new View.0nCLickListener() { 
@Override 


public void onClick(View v) { 


而 用 Kotlin 代 码 实 现 同 样 的 功能 ， 就 可 以 使 用 沙 数 式 API 的 写法 来 对 代码 进行 简化 ,结果 如 下 : 


button.setOnClickListener { 
} 


可 以 看 到 ， 使 用 这 种 写法 ， 代 码 明 显 精简 了 很 多 。 这 上 段 给 按钮 注册 点 击 事件 的 代码 , 我们 在 正 
式 开始 学 习 Android 程 序 开发 之 后 将 会 经 常用 到 。 


最 后 提醒 你 一 名 ， 本 小 节 中 学 习 的 java 函 数 式 API 的 使 用 都 限定 于 从 Kotlin 中 调用 java 方 法， 并 
且 单 抽象 方法 接口 也 必须 是 用 Java 语言 定义 的 。 你 可 能 会 好 奇 为 什么 要 这 样 设 计 。 这 是 因为 
Kotlin 中 有 专门 的 高 阶 沙 数 来 实现 更 加 强大 的 自 定义 函数 式 API 功 能 ， 从 而 不 需要 像 java 这 样 借 
助 单 抽象 方法 接口 来 实现 。 关 于 高 阶 函 数 的 用 法 ， 我 们 会 在 本 书 的 第 6 章 进 行 学 习 。 
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2.7” 空 指针 检查 


我 之 前 看 过 某国 外 机 构 做 的 一 个 统计 ，Android 系 统 上 月 演 率 最 高 的 异常 类 型 就 是 空 指 针 异 常 

(NullPointerException) 。 相 信 不 只 是 Android ， 其 他 系统 上 也 面临 着 相同 的 问题 。 若 要 分 
析 其 根本 原因 的 话 ， 我 觉得 主要 是 因为 空 指针 是 一 种 不 受 编程 语言 检查 的 运行 时 异常 ， 只 能 由 
程序 员 主 动 通 过 逻辑 判断 来 避免 ， 但 即使 是 最 出 色 的 程序 员 ， 也 不 可 能 将 所 有 港 在 的 空 指针 异 
常 全 部 考虑 到 。 


我 们 来 看 一 段 非常 简单 的 java 代 码 : 


public void doStudy(Study study) { 
study. readBooks (); 
study.doHomework() 

} 


这 是 我 们 在 2.5.3 小 节 编 写 过 的 一 个 doStudy() 方 法 ,我 将 它 翻 译 成 了 Java 版 。 这 段 代 码 没有 
任何 复杂 的 逻辑 ,只 是 接收 了 一 个 Study 参 数 ， 并 且 调 用 了 参数 的 readBooks ( ) 和 
doHomework( ) 方 法 。 


这 段 代码 安全 吗 ? 不 一 定 ， 因 为 这 要 取决 于 调用 方 传 入 的 参数 是 什么 ， 如 果 我 们 向 doStudy () 
方法 传 入 了 一 个 null 参 数 ， 那 么 之 无 疑问 这 里 就 会 发 生 空 指 针 异 常 。 因 此 ,更 加 稳妥 的 做 法 是 
在 调用 参数 的 方法 之 前 先进 行 一 个 判 空 处 理 ， 如 下 所 示 : 


public void doStudy(Study study) { 
if (study != null) { 
study.readBooks (); 
study.doHomework(); 
} 


} 
这 样 就 能 保证 不 管 传 入 的 参数 是 什么 ， 这 段 代 码 始 终 都 是 安全 的 。 

由 此 可 以 看 出 ， 即 使 是 如 此 简单 的 一 小 段 代码 ， 都 有 产生 空 指针 异常 的 潜在 风险 ， 那么 在 一 个 
大 型 项 目 中 ， 想 要 完全 规避 空 指针 异常 几乎 是 不 可 能 的 事情 ， 这 也 是 它 高 居 各 类 前 省 排行 榜首 
位 的 原因 。 


2.7.1 可 空 类 型 系统 

然而 ，Kotlin 却 非常 科学 地 解决 了 这 个 问题 ， 它 利用 编译 时 判 空 检查 的 机 制 几乎 杜绝 了 空 指针 异 
常 。 虽 然 编译 时 判 空 检查 的 机 制 有 时 候 会 导致 代码 变 得 比较 难 写 ， 但 是 不 用 担心 ，Kotlin 提 供 了 
一 系列 的 辅助 工具 ， 让 我 们 能 轻松 地 处 理 各 种 判 空 情况 。 下 面 我 们 就 逐步 开始 学 习 吧 。 


还 是 回 到 刚才 的 doStudy ( ) 消 数 ， 现 在 将 这 个 水 数 再 翻译 回 Kotlin 版 本 ， 代 码 如 下 所 示 : 


fun doStudy(study: Study) { 
study. readBooks () 
study.doHomework() 

J 
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这 段 代 码 看 上 去 和 刚才 的 Java 版 本 并 没有 什么 区 别 ， 但 实际 上 它 是 没有 空 指针 风险 的 ， 因 为 
Kotlin 默 认 所 有 的 参数 和 变量 都 不 可 为 空 ， 所 以 这 里 传 入 的 Study 参 数 也 一 定 不 会 为 空 ， 我 们 可 
以 放心 地 调用 它 的 任何 函数 。 如 果 你 尝试 向 doStudy ( ) 函 数 传 入 一 个 nuLL 参 数 ， 则 会 提示 如 图 
2.30 所 示 的 错误 。 


fun main() { 


dostudy( study: nuLL) 
: 


Null can not be a value of a non-null type Study 


fun doStudy(study: Study) { 
study. readBooks () 
study.doHomework() 


图 2.30 向 doStudy ( ) 方 法 传 入 nuLL 人 参数 


也 就 是 说 ，Kotlin 将 空 指针 异常 的 检查 提前 到 了 编译 时 期 ， 如 果 我 们 的 程序 存在 空 指 针 异 常 的 风 
险 ， 那么 在 编译 的 时 候 会 直接 报错 ， 修 正之 后 才能 成 功 运行 ， 这 样 就 可 以 保证 程序 在 运行 时 期 
不 会 出 现 空 指 针 异 常 了 。 


看 到 这 里 ， 你 可 能 产生 了 巨大 的 疑惑 ， 所 有 的 参数 和 变量 都 不 可 为 空 ? 这 可 真是 前 所 未 闻 的 事 
情 ， 那 如 果 我 们 的 业务 逻辑 就 是 需要 某 个 参数 或 者 变量 为 空 该 怎么 办 呢 ? 不 用 担心 ，Kotlin 提 供 
了 另外 一 套 可 为 空 的 类 型 系统 ， 只 不 过 在 使 用 可 为 空 的 类 型 系统 时 ， 我们 需要 在 编译 时 期 就 将 
所 有 潜在 的 空 指 针 异 常 都 处 理 掉 ， 否 则 代码 将 无 法 编译 通过 ，。 


那么 可 为 空 的 类 型 系统 是 什么 样 的 呢 ? 很 简单 ， 就 是 在 类 名 的 后 面 加 上 一 个 问号 。 比 如 ，Int 表 
示 不 可 为 空 的 整 型 ， 而 Int? 就 表示 可 为 空 的 整 型 ; St ring 表 示 不 可 为 空 的 字符 串 ， 而 
String? 就 表示 可 为 空 的 字符 串 。 


回 到 刚才 的 doStudy ( ) 细 数 ， 如 果 我 们 希望 传 入 的 参数 可 以 为 空 ， 那 么 就 应 该 将 参数 的 类 型 由 
Study 改 成 Study? ,如 图 2.31 所 示 。 


fun main() { 
dostudy( study: null) 


fun doStudy(study: Study?) { 
study. readBooks() 
study.doHomework() 


图 2.31 人 允许 Study 参 数 为 空 

可 以 看 到 ,现在 在 调用 doStudy ( ) 函数 时 传 入 nuLL 参 数 ， 就 不 会 再 提示 错误 了 。 人 然而 你 会 发 
现 , 在 doStudy ( ) 函 数 中 调用 参数 的 readBooks( ) 和 doHomework( ) 方 法 时 , 却 出 现 了 一 个 
红色 下 滑 线 的 错误 提示 ， 这 又 是 为 什么 呢 ? 


其 实 原因 也 很 明显 ， 由 于 我 们 将 参数 改 成 了 可 为 空 的 study? 类 型 ， 此 时 调用 参数 的 
readBooks () 和 doHomework() 方 法 都 可 能 造成 空 指针 异常 ， 因 此 Kotlin 在 这 种 情况 下 不 允许 


www.blogss.cn 


那么 该 如 何 解决 呢 ? 很 简单 ， 只 要 把 空 指针 异常 都 处 理 掉 就 可 以 了 ， 比 如 做 个 判断 处 理 ， 如 下 
所 示 : 


fun doStudy(study: Study?) { 
if (study != null) { 
study.readBooks() 
study.doHomework() 
} 


} 
现在 代码 就 可 以 正常 编译 通过 了 ， 并 且 还 能 保证 完全 不 会 出 现 空 指针 异常 。 


其 实学 到 这 里 ， 我 们 就 已 经 基本 掌握 了 Kotlin 的 可 空 类 型 系统 以 及 空 指针 检查 的 机 制 ， 但 是 为 了 
在 编译 时 期 就 处 理 掉 所 有 的 空 指针 异常 ， 通 常 需要 编写 很 多 额外 的 检查 代码 才 行 。 如 果 每 处 检 
查 代码 都 使 用 if 判断 语句 ， 则 会 让 代码 变 得 比较 咖 叶 ， 而 且 if 判 断 语句 还 处 理 不 了 全 局 变量 的 
判 空间 题 。 为 此 ，Kotlin 专 门 提供 了 一 系列 的 辅助 工具 ， 使 开发 者 能 够 更 轻松 地 进行 判 空 处理 ， 
下 面 我 们 就 来 逐个 学 习 一 下 。 


2.7.2 判 空 辅助 工具 


首先 学 习 最 常用 的 ? .操作 符 。 这 个 操作 符 的 作用 非常 好 理解 ， 就 是 当 对 象 不 为 空 时 正常 调用 相 
应 的 方法 ， 当 对 象 为 空 时 则 什么 都 不 做 。 比 如 以 下 的 判 空 处 理 代 码 : 


if (a != null) { 
a.doSomething() 


这 段 代 码 使 用 ? .操作 符 就 可 以 简化 成 : 


a?.doSomething() 


了 解 了 ? .操作 符 的 作用 ， 下 面 我 们 来 看 一 下 如 何 使 用 这 个 操作 符 对 doStudy ( ) 哺 数 进 行 优 化 ， 
代码 如 下 所 示 : 


fun doStudy(study: Study?) { 
study?.readBooks() 
study?.doHomework() 


} 


可 以 看 到 ， 这样 我 们 就 借助 ? ,操作 符 将 if 判 断 语句 去 掉 了 。 可 能 你 会 觉得 使 用 if 语 名 来 进行 判 
空 处 理 也 没什么 复杂 的 ， 那 是 因为 目前 的 代码 还 非常 简单 ， 当 以 后 我 们 开发 的 功能 越 来 越 复 
杂 , 需要 判 空 的 对 象 也 越 来 越 多 的 时 候 ， 你 就 会 觉得 ? .操作 符 特 别 好 用 了 。 


下 面 我 们 再 来 学 习 另 外 一 个 非常 常用 的 ? :操作 符 。 这 个 操作 符 的 左右 两 边 都 接收 一 个 表达 式 ， 
如 果 左 边 表达 式 的 结果 不 为 空 就 返回 左边 表达 式 的 结果 ， 否则 就 返回 右边 表达 式 的 结果 。 观 察 
如 下 代码 : 
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valL c= if (a! = null) { 
} 站 { 

b 
} 
这 上段 代码 的 逻辑 使 用 ? :操作 符 就 可 以 简化 成 : 


valL Cc =a?:b 


接 下 来 我 们 通过 一 个 具体 的 例子 来 结合 使 用 ? .和 ? :这 两 个 操作 符 ， 从 而 让 你 加 深 对 它们 的 理 


解 。 


比如 现在 我 们 要 编写 一 个 函数 用 来 获得 一 段 文本 的 长 度 ， 使 用 传统 的 写法 就 可 以 这 样 写 : 


fun getTextLength(text: String?): Int { 
if (text != null) { 
return text.length 
} 


return 0 


由 于 文本 是 可 能 为 空 的 ， 因 此 我 们 需要 先进 行 一 次 判 空 操作 ， 如 果 文 本 不 为 空 就 返回 它 的 长 
度 ， 如 果 文 本 为 空 就 返回 0。 


这 上段 代码 看 上 去 也 并 不 复杂 ,但 是 我 们 却 可 以 借助 操作 符 让 它 变 得 更 加 简单 ， 如 下 所 示 : 


fun getTextLength(text: String?) = text?.length ?: 0 


这 里 我 们 将 ? .和 ? :操作 符 结 合 到 了 一 起 使 用 ,首先 由 于 text 是 可 能 为 空 的 ， 因 此 我 们 在 调用 它 
的 Length 字 段 时 需要 使 用 ? .操作 符 , 而 当 text 为 空 时 ， text?.Length 会 返回 一 个 nuLL 值 ， 
这 个 时 候 我 们 再 借助 ? : 操作 符 让 它 返 回 0。 怎 么 样 ， 是 不 是 觉得 这 些 操作 符 越 来 越 好 用 了 呢 ? 


不 过 Kotlin 的 空 指针 检查 机 制 也 并 非 总 是 那么 智能 ， 有 的 时 候 我 们 可 能 从 逻辑 上 已 经 将 空 指针 腊 
常 处 理 了 ， 但 是 Kotlin 的 编译 器 并 不 知道 ， 这 个 时 候 它 还 是 会 编译 失败 。 


观察 如 下 的 代码 示例 : 


var content: String? = "hello" 


fun main() { 
if (content != null) { 
printUpperCase() 


} 
fun printUpperCase() { 


val upperCase = content.toUpperCase() 
println(upperCase) 


这 里 我 们 定义 了 一 个 可 为 空 的 全 局 变量 content , 然后 在 main( ) 函 数 里 先进 行 一 次 判 空 操作 ， 
当 content 不 为 空 的 时 候 才 会 调用 printUpperCase() 函 数 , 在 printUpperCase( ) 函 数 
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里 ,我们 将 content 转 换 为 大 写 模 式 ， 最 后 打印 出 来 。 


看 上 去 好 像 逻 辑 没什么 问题 ， 但 是 很 遗憾 ， 这 段 代码 一 定 是 无 法 运行 的 。 因 为 
printUpperCase() 函 数 并 不 知道 外 部 已 经 对 content 变 量 进行 了 非 空 检查 ， 在 调用 
toUpperCase() 方 法 时 ， 还 认为 这 里 存在 空 指针 风险 ， 从 而 无 法 编译 通过 。 


在 这 种 情况 下 ， 如 果 我 们 想 要 强行 通过 编译 ， 可 以 使 用 非 空 断言 工具 ， 写 法 是 在 对 象 的 后 面 加 
上 !1 ,如 下 所 示 : 


fun printUpperCase() { 
val upperCase = content!!.toUpperCase() 
println(upperCase) 


这 是 一 种 有 风险 的 写法 ， 意 在 告诉 Kotlin， 我 非常 确信 这 里 的 对 象 不 会 为 空 ， 所 以 不 用 你 来 帮 我 
做 空 指针 检查 了 ， 如 果 出 现 问题 ， 你 可 以 直接 抛 出 空 指针 异常 ， 后 果 由 我 自己 承担 。 


虽然 这 样 编写 代码 确实 可 以 通过 编译 ， 但 是 当 你 想 要 使 用 非 空 断言 工具 的 时 候 ， 最 好 提醒 一 下 
自己 ， 是 不 是 还 有 更 好 的 实现 方式 。 你 最 自信 这 个 对 象 不 会 为 空 的 时 候 ， 其 实 可 能 就 是 一 个 洪 
在 空 指针 异常 发 生 的 时 候 。 

最 后 我 们 再 来 学 习 一 个 比较 与 众 不 同 的 辅助 工具 一 一 Let。Let 婚 不 是 操作 符 ， 也 不 是 什么 关键 


字 ， 而 是 一 个 函数 。 这 个 函数 提供 函 数 式 API 的 编程 接口 ， 并 将 原始 调用 对 象 作为 参数 传递 到 
Lambda 表 达 式 中 。 示 例 代 码 如 下 : 


obj.let { obj2 -> 
// 编写 具体 的 业务 逻辑 


可 以 看 到 ， 这 里 调用 了 obj 对 象 的 Let 上 函数， 然后 Lambda 表 达 式 中 的 代码 就 会 立即 执行 ， 并 且 
这 个 0bj 对 象 本 身 还 会 作为 参数 传递 到 Lambda 表 达 式 中 。 不 过 ,为 了 防止 变量 重 名 ， 这 里 我 将 
参数 名 改 成 了 obj2， 但 实际 上 它们 是 同一 个 对 象 ， 这 就 是 Let 函 数 的 作用 。 


Let 函 数 属于 Kotlin 中 的 标准 函数 ， 在 下 一 章 中 我 们 将 会 学 习 更 多 Kotlin 标 准 函 数 的 用 法 。 


你 可 能 就 要 问 了 ， 这 个 Let 函 数 和 空 指 针 检 查 有 什么 关系 呢 ? 其 实 Let 了 少数 的 特性 配合 ? ,操作 符 
可 以 在 空 指针 检查 的 时 候 起 到 很 大 的 作用 。 


我 们 回 到 doStudy ( ) 明 数 当中 ， 目 前 的 代码 如 下 所 示 : 


fun doStudy(study: Study?) { 
study?.readBooks() 
study?.doHomework() 


} 


虽然 这 段 代 码 我 们 通过 ? . 操作 符 优化 之 后 可 以 正常 编译 通过 ， 但 其 实 这 种 表达 方式 是 有 点 鹃 叶 
的 ， 如 果 将 这 段 代 码 准确 翻译 成 使 用 if 判断 语句 的 写法 ， 对 应 的 代码 如 下 : 


fun doStudy(study: Study?) { 
if (study != null) { 
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study.readBooks() 


} 
if (study != null) { 
study.doHomework() 


} 


也 就 是 说 ， 本 来 我 们 进行 一 次 if 判 断 就 能 随意 调用 study 对 象 的 任何 方法 ,但 受制 于 ? ,操作 符 
的 限制 ， 现在 变 成 了 每 次 调用 study 对 象 的 方法 时 都 要 进行 一 次 if 判 断 。 


这 个 时 候 就 可 以 结合 使 用 ? .操作 符 和 Let 函数 来 对 代码 进行 优化 了 ， 如 下 所 示 : 


fun doStudy(study: Study?) { 
study?.let { stu -> 
stu. readBooks () 
stu.doHomework() 


} 


} 


我 来 简单 解释 一 下 上 述 代码 ，? ,操作 符 表示 对 和 象 为 空 时 什么 都 不 做 ， 对 和 象 不 为 空 时 就 调用 Let 
也 数 ， 而 Let 了 少数 会 将 study 对 象 本身 作 为 参数 传递 到 Lambda 表 达 式 中 ， 此 时 的 study 对 象 肯 
定 不 为 空 了 ， 我 们 就 能 放心 地 调用 它 的 任意 方法 了 。 


另外 还 记得 Lambda 表 达 式 的 语法 特性 吗 ? 当 Lambda 表 达 式 的 参数 列表 中 只 有 一 个 参数 时 ， 
可 以 不 用 声明 参数 名 ， 直 接 使 用 让 关键 字 来 代 蔡 即 可 ， 那 么 代码 就 可 以 进一步 简化 成 : 


fun doStudy(study: Study?) { 
study?.let { 
it.readBooks() 
it.doHomework() 


} 


} 


在 结束 本 小 节 内 容 之 前 ， 我 还 得 再 讲 一 点 ,Let 函数 是 可 以 处 理 全 局 变量 的 判 空间 题 的 ,而 站 f 
判断 语句 则 无 法 做 到 这 一 点 。 比 如 我 们 将 doStudy ( ) 函数 中 的 参数 变 成 一 个 全 局 变量 ， 使 用 
Let 盟 数 仍然 可 以 正常 工作 ， 但 使 用 证 判 断 语句 则 会 提示 错误 ,如 图 2.32 所 示 。 


Var study: Study? = null 


fun doStudy() { 
if (study != null) { 
study. readBooks () 
study,doHomework() 
} 
} 


图 2.32 使 用 if 判 断 语句 对 全 局 变量 进行 判 空 
之 所 以 这 里 会 报错 ， 是 因为 全 局 变量 的 值 随 时 都 有 可 能 被 其 他 线程 所 修改 ， 即 使 做 了 判 空 处 


理 ， 仍然 无 法 保证 i1f 语 名 中 的 study 变 量 没 有 空 指针 风险 。 从 这 一 点 上 也 能 体现 出 let 少数 的 
优势 。 
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好 了 ， 最 常用 的 Kotlin 空 指针 检查 辅助 工具 大 概 就 是 这 些 了 ， 只 要 能 将 本 节 的 内 容 掌握 好 ， 你 就 
可 以 写 出 更 加 健壮 、 几 了 乎 杜绝 空 指针 异常 的 代码 了 。 
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2.8 Kotlin 中 的 小 魔术 


到 目前 为 止 ， 我 们 已 经 学 习 了 很 多 Kotlin 方 面 的 编程 知识 ， 相 信 现 在 的 你 已 经 有 能 力 进行 一 些 日 
常 的 Kotlin 开 发 工作 了 。 在 结束 本 章 内 容 之 前 ， 我 们 再 来 学 习 几 个 魔术 类 的 小 技巧 ， 虽 说 是 小 技 
巧 ， 但 是 相信 我 ， 它 们 一 定 会 给 你 带 来 巨大 的 帮助 。 

2.8.1 字符 串 内 椒 表 达 式 

字符 串 内 骸 表 达 式 是 我 认为 Java 最 应 该 支持 的 功能 ， 因 为 大 多 数 现代 高 级 语言 是 支持 这 个 非常 
方便 的 功能 的 ， 但 是 java 直 到 今天 都 还 不 支持 ， 至 于 为 什么 ， 我 也 想 不 明 白 ， 或 许 java 的 开发 
团队 有 不 这 人 么 做 的 原因 和 道理 吧 。 


不 过 值得 高 兴 的 是 ，Kotlin 从 一 开始 就 支持 了 字符 串 内 艇 表达 式 的 功能 ,弥补 了 Java 在 这 一 点 上 
的 遗憾 。 在 Kotlin 中 ， 我 们 不 需要 再 像 使 用 ava 时 那样 傻 傻 地 拼接 字符 串 了 ， 而 是 可 以 直接 将 表 
达 式 写 在 字符 串 里 面 ， 即 使 是 构建 非常 复杂 的 字符 串 ， 也 会 变 得 轻而易举 。 


本 书 到 目前 为 止 ， 我 都 还 没有 使 用 过 字符 串 内 肉 表 达 式 的 与 法 ， 一 直 在 使 用 传统 的 加 号 连接 符 
来 拼接 字符 串 。 在 学 完 本 节 的 内 容 之 后 ， 我 们 就 会 永远 和 加 号 连接 符 的 写法 说 “再 见 "了 。 


首先 来 看 一 下 Kotlin 中 字符 串 内 藤 表 达 式 的 语法 规则 : 


可 以 看 到 ，Kotlin 允 许 我 们 在 字符 串 里 嵌入 ${} 这 种 语法 结构 的 表达 式 ， 并 在 运行 时 使 用 表达 式 
执行 的 结果 替代 这 一 部 分 内 容 。 


另外 ， 当 表达 式 中 仅 有 一 个 变量 的 时 候 ， 还 可 以 将 两 边 的 大 括号 省 略 ， 如 下 所 示 : 
这 种 字符 串 内 肉 表 达 式 的 写法 到 底 有 多 么 方便 ， 我 们 通过 一 个 具体 的 例子 来 学 习 一 下 就 知道 


了 。 在 2.5.4 小 节 中 ， 我 们 用 Java 编写 了 一 个 CeLLphone 数 据 类 , 其 中 toString () 方 法 里 就 
使 用 了 比较 复杂 的 拼接 字符 串 的 写法 。 这 里 我 将 当时 的 拼接 逻辑 单独 提炼 了 出 来 ， 代 码 如 下 : 


val brand = "Samsung" 
val price = 1299.99 
println("Cellphone(brand=" + brand + ", price=" + price + ")") 


可 以 看 到 ， 上 述 字 符 串 中 一 共 使 用 了 4 个 加 号 连接 符 ， 这 种 与 法 不 仅 写 起 来 非常 吃力 ， 很 容易 与 
错 ， 而 且 在 代码 可 读 性 方面 也 很 糟糕。 


而 使 用 字符 串 内 肉 表 达 式 的 与 法 就 变 得 非常 简单 了 ， 如 下 所 示 : 


val brand = "Samsung" 
val price = 1299.99 
println("Cellphone(brand=$brand, price=$price)") 
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很 明显 ， 这 种 写法 不 管 是 在 易 读 性 还 是 易 写 性 方面 都 更 胜 一 筹 , 是 Kotlin 更 加 推崇 的 与 法 。 这 个 
小 技巧 会 给 我 们 以 后 的 开发 工作 带 来 巨大 的 便利 。 


2.8.2 函数 的 参数 默认 值 
接 下 来 我 们 开始 学 习 另 外 一 个 非常 有 用 的 小 技巧 一 一 给 函数 设 定 参 数 默认 值 。 


其 实 之 前 在 学 习 次 构造 亢 数 用 法 的 时 候 我 就 提 到 过 ， 次 构造 函数 在 Kotlin 中 很 少 用 ， 因 为 Kotlin 
提供 了 给 冰 数 设 定 参数 默认 值 的 功能 ， 尼 在 很 大 程度 上 能 够 蔡 代 次 构造 永 数 的 作用 。 


具体 来 讲 ， 我 们 可 以 在 定义 函数 的 时 候 给 任意 参数 设 定 一 个 默认 值 ， 这 样 当 调用 此 毅 数 时 就 不 
会 强制 要 求 调用 方 为 此 参数 传 值 ， 在 没有 传 值 的 情况 下 会 自动 使 用 参数 的 默认 值 。 


给 参数 设 定 默认 值 的 方式 也 很 简单 ， 观 察 如 下 代码 : 


fun printParams (num: Int, str: String = "hello") { 
println("num is $num , str is $str") 


可 以 看 到 ， 这 里 我 们 给 printParams ( ) 少数 的 第 二 个 参数 设 定 了 一 个 默认 值 ， 这 样 当 调用 
printParams() 消 数 时 ， 可 以 选择 给 第 二 个 参数 传 值 , 也 可 以 选择 不 传 ， 在 不 传 的 情况 下 就 会 
自动 使 用 默认 值 。 


现在 我 们 在 main ( ) 盟 数 中 调用 一 人 printParams ( ) 涵 数 来 进行 测试 ， 代 码 如 下 : 


fun printParams(num: Int, str: String = "hello") { 
println("num is $num , str is $str") 


fun main() { 
printParams (123) 


注意 ,这 里 并 没有 给 第 二 个 参数 传 值 。 运 行 一 下 代码 ， 结 果 如 图 2.33 所 示 。 


Run: ~ com.example.helloworld.LearnKotlinKt 


p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
num is 123 , str is hello 


Process finished with exit code 0 


lt dl 


图 2.33 str 参数 使 用 默认 值 的 打印 结果 


可 以 看 到 ， 在 没有 给 第 二 个 参数 传 值 的 情况 下 ，printParams ( ) 消 数 自动 使 用 了 参数 的 默认 
值 。 


当然 上 面 这 个 例子 比较 理想 化 ,因为 正好 是 给 最 后 一 个 参数 设 定 了 默认 值 ， 现 在 我 们 将 代码 改 
成 给 第 一 个 参数 设 定 默认 值 ， 如 下 所 示 : 
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fun printParams (num: Int = 100, str: String) { 
println("num is $num , str is $str") 


} 


这 时 如 果 想 让 num 参 数 使 用 默认 值 该 怎么 办 呢 ? 模仿 刚才 的 写法 肯定 是 行 不 通 的 ， 因 为 编译 郑 会 
认为 我 们 想 把 字符 串 赋 值 给 第 一 个 num 参 数 ， 从 而 报 类 型 不 匹配 的 错误 ， 如 图 2.34 所 示 。 


fun printParams(num: Int = 100，str: String) { 
println("num is $num , str is $str") 


上 


fun main() { 
printParams( num: "world") 


Type mismatch. 
Required: Int 
Found: String 


图 2.34 ”类 型 不 匹配 错误 提示 

不 过 不 用 担心 ，Kotlin 提 供 了 另外 一 种 神奇 的 机 制 ， 就 是 可 以 通过 键 值 对 的 方式 来 传 参 ， 从 而 不 
必 像 传统 写法 那样 按照 参数 定义 的 顺序 来 传 参 。 比 如 调用 printParams ( ) 函 数 ， 我 们 还 可 以 这 
样 与 : 


printParams(str = "world", num = 123) 


此 时 哪个 参数 在 前 哪个 参数 在 后 都 无 所 谓 ，Kotlin 可 以 准确 地 将 参数 匹配 上 。 而 使 用 这 种 键 值 对 
的 传 参 方式 之 后 ， 我 们 就 可 以 省 略 num 参 数 了 ， 代 码 如 下 : 


fun printParams(num: Int = 100, str: String) { 
println("num is $num , str is $str") 


} 


fun main() { 
printParams(str = "world") 


重新 运行 一 下 程序 ， 结 果 如 图 2.35 所 示 。 


Run: 三 com.example.helloworld.LearnKotlinKt 
"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" . . . 


> num is 100 , str is world 


Process finished with exit code 0 


le I 


图 2.35 num 参 数 使 用 默认 值 的 打印 结果 


现在 你 已 经 掌握 了 如 何 给 函数 设 定 参 数 默认 值 ， 那 么 为 什么 说 这 个 功能 可 以 在 很 大 程度 上 蔡 代 
次 构造 永 数 的 作用 呢 ? 
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回忆 一 下 当初 我 们 学 习 次 构造 消 数 时 所 编写 的 代码 : 


class Student(val sno: String, val grade: Int, name: String, age: Int) : 
Person(name, age) { 
constructor(name: String, age: Int) : this("", 0, name, age) { 


constructor() : this("", 0) { 


} 
上 述 代码 中 有 一 个 主 构造 溺 数 和 两 个 次 构造 水 数 ， 次 构造 溺 数 在 这 里 的 作用 是 提供 了 使 用 更 少 
参数 来 对 Student 类 进行 实例 化 的 方式 。 无 参 的 次 构造 水 数 会 调用 两 个 参数 的 次 构造 永 数 ， 并 
将 这 两 个 参数 赋值 成 初始 值 。 两 个 参数 的 次 构造 函数 会 调用 4 个 参数 的 主 构造 水 数 ， 并 将 缺失 的 
两 个 参数 也 赋值 成 初始 值 。 

这 种 写法 在 Kotlin 中 其 实 是 不 必要 的 ， 因 为 我 们 完全 可 以 通过 只 编写 一 个 主 构造 水 数 ， 然 后 给 参 
数 设 定 默认 值 的 方式 来 实现 ， 代 码 如 下 所 示 : 


class Student(val sno: String = "", val grade: Int = 0, name: String = "", age: Int = 0) : 
Person(name, age) { 


} 


在 给 主 构造 肖 数 的 每 个 参数 都 设 定 了 默认 值 之 后 ,我们 就 可 以 使 用 任何 传 参 组 合 的 方式 来 对 
Student 类 进行 实例 化 ,当然 也 包含 了 刚才 两 种 次 构造 当 数 的 使 用 场景 。 


由 此 可 见 ， 给 少数 设 定 参 数 上 默认 值 这 个 小 技巧 的 作用 还 是 极 大 的 。 
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2.9 小 结 与 点 评 


本 章 的 内 容 可 着 实 不 少 ， 在 这 一 章 里 面 ， 我 们 全 面 学 习 了 Kotlin 编 程 中 最 主要 的 知识 点 ， 包 括 变 
量 和 函数 、 罗 辑 控制 语句 、 面 向 对 象 编程 、Lambda 编 程 、 空 指针 检查 机 制 ， 等 等 。 虽 然 这 还 
远 不 足以 涵盖 Kotlin 的 所 有 内 容 ， 但 是 这 里 我 要 祝 货 你 ， 现 在 你 已 经 有 足够 的 实力 使 用 Kotlin 来 
学 习 Android 程 序 开 发 了 。 

因此 ， 从 下 一 章 开始 ， 我们 将 正式 踏 上 Android 开 发 学 习 之 旅 。 不 过 在 这 之 后 的 每 一 章 里 ， 我 都 
会 结合 相应 章节 的 内 容 穿插 讲解 一 些 Kotlin 进 阶 方面 的 知识 ， 从 而 让 你 在 Android 和 Kotlin 两 方 
面 都 能 够 持续 不 断 地 进步 。 那 么 稍 事 休息 ， 让 我 们 继续 前 行 吧 ! 
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第 3 章 ” 先 从 看 得 到 的 入 手 ， 探究 Activity 


通过 第 1 章 的 学 习 ， 你 已 经 成 功 创建 了 第 一 个 Android 项 目 。 不 过 ， 仪 仅 满足 于 此 显然 是 不 够 

, 是 时 候 学 点 新 的 东西 了 。 作 为 你 的 导师 ， 我 有 义务 帮 你 制定 好 后 面 的 学 习 路 线 ， 那 么 今天 
我 们 应 该 从 哪儿 入 手 呢 ? 现在 你 可 以 想象 一 下 ， 假 如 你 已 经 写 出 了 一 个 非常 优秀 的 应 用 程序 ， 
然后 推荐 给 你 的 第 一 个 用 户 ， 你 会 从 哪里 开始 介绍 呢 ?之 无 疑问 ,当然 是 从 界面 开始 介绍 了 ! 
因为 即使 你 的 程序 算法 再 高 效 ， 架 构 再 出 色 ， 用 户 也 根本 不 会 在 乎 这 些 ， 他 们 一 开始 只 会 对 看 
得 到 的 东西 感 兴趣 ， 那 么 我 们 今天 的 主题 自然 要 从 看 得 到 的 入 手 了 。 
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3.1 Activity 是 什么 


Activity 是 最 容易 吸引 用 户 的 地 方 ， 它 是 一 种 可 以 包含 用 户 界面 的 组 件 ， 主 要 用 于 和 用 户 进行 交 
互 。 一 个 应 用 程序 中 可 以 包含 零 个 或 多 个 Activity , 但 不 包含 任何 Activity 的 应 用 程序 很 少见 ， 
谁 也 不 想 让 自己 的 应 用 永远 无 法 被 用 户 看 到 吧 ? 


其 实在 第 1 章 中 ， 你 已 经 和 Activity 打 过 交道 了 ， 并 且 对 Activity 有 了 初步 的 认识 。 不 过 当时 的 
重点 是 创建 你 的 第 一 个 Android 项 目 ， 对 Activity 的 介绍 并 不 多 ， 在 本 章 中 ， 我 将 对 Activity 进 
行 详细 的 介绍 。 
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3.2 ” Activity 的 基本 用 法 
到 现在 为 止 ， 你 还 没有 手动 创建 过 Activity 呢 ， 因 为 第 1 章 中 的 MainActivity 是 Android Studio 
自动 帮 有 我 们 创建 的 。 手 动 创 建 Activity 可 以 加 深 我 们 的 理解 ， 因 此 现在 是 时 候 自己 动手 了 。 


我 们 先 将 当前 的 项 目 关闭 ， 点 击 导航 栏 File 一 Close Project。 然 后 再 新 建 一 个 Android 项 目 ,新 
建 项 目的 步骤 你 已 经 在 第 1 章 学 习 过 了 ,不 过 图 1.9 中 的 那 一 步 需要 稍 做 修改 ， 我们 不 再 选 
择 “Empty Activity" 这 个 选项 ， 而 是 选择 Add No Activity”, 如 图 3.1 所 示 。 


We Create New Project 
Choose your project 


Phone and Tablet Wear OS TV Android Auto Android Things 


[ES FE 
Add No Activity 
Basic Activity Empty Activity Bottom Navigation Activity 


EP 
~ 


Fullscreen Activity Master/Detail Flow Navigation Drawer Activity Google Maps Activity 
Add No Activity 
Creates a new empty project 
Gomes | | Piere EE 


图 3.1 选择 不 添加 Activity 
点 击 “Next" 进 入 项 目 配置 界面 。 


项 目 名 可 以 叫 作 ActivityTest, 包 名 我 们 就 使 用 默认 值 com.example.activitytest , 其 他 选项 
都 和 第 1 章 创建 的 项 目 保持 一 致 。 点 击 “Finish”, 等 待 Gradle 构 建 完成 后 ， 项 目 就 创建 成 功 了 。 
3.2.1 手动 创建 Activity 


项 目 创建 成 功 后 ， 仍 然 会 默认 使 用 Android 模 式 的 项 目 结构 ， 这 里 我 们 手动 改 成 Project 模 式 ， 
本 书后 面 的 所 有 项 目 都 要 这 样 修改 ， 以 后 就 不 再 殴 述 了 。 目 前 ActivityTest 项 目 中 虽然 还 是 会 
动 生成 很 多 文件 ,但 是 app/src/main/java/com.example.activitytest 目 录 将 会 是 空 的 ,如 
图 3.2 所 示 。 
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mm ActivityTest ~/AndroidStudioProjects/Android 
MN .gradle 
.idea 
3 app 

build 

libs 

src 
androidTest 
main 
MM java 


com.example.activitytest 


=res 
区 AndroidManifest.xml 
test 
引 .gitignore 
2 app.iml 
oR build.gradle 
proguard-rules.pro 


图 3.2 初始 项 目 结 构 


现在 右 击 com.example.activitytest 包 New 一 ActivityEmpty Activity ,会 弹出 一 个 创建 
Activity 的 对 话 框 ， 我们 将 Activity 命 名 为 FirstActivity , 并且 不 要 勾 选 Generate Layout File 


和 Launcher Activity 这 两 个 选项 ， 如 图 3.3 所 示 。 
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@e® New Android Activity 


Configure Activity 


Android Studio 


Creates a new empty activity 


Activity Name: FirstActivity 


Generate Layout File 
[1 Launcher Activity 


Backwards Compatibility (AppCompat) 


Package name: com.example.activitytest v 
Source Language: Kotlin 4 


图 3.3 ”新建 Activity 对 话 框 


勾 选 Generate Layout File 表 示 会 自动 为 FirstActivity 创 建 一 个 对 应 的 布局 文件 ， 勾 选 
Launcher Activity 表 示 会 自动 将 FirstActivity 设 置 为 当前 项 目的 主 Activity。 由 于 你 是 第 一 次 
手动 创建 Activity， 这 些 自动 生成 的 东西 暂时 都 不 要 勾 选 ， 下 面 我 们 将 会 一 个 个 手动 来 完成 。 义 
选 Backwards Compatibility 表 示 会 为 项 目 局 用 向 下 兼容 旧版 系统 的 模式 ， 这 个 选项 要 勾 上 。 
点 击 “Finish” 完 成 创建 。 


你 需要 知道 ， 项 目 中 的 任何 Activity 都 应 该 重 写 onCreate ( ) 方 法 ， 而 目前 我 们 的 FirstActivity 
中 已 经 重 写 了 这 个 方法 , 这 是 Android Studio 自 动 帮 我 们 完成 的 ， 代码 如 下 所 示 : 


class FirstActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


} 


可 以 看 到 ，onCreate() 方 法 非常 简单 ， 就 是 调用 了 父 类 的 onCreate( ) 方 法 。 当 然 这 只 是 加 
认 的 实现 ， 后 面 我 们 还 需要 在 里 面 加 入 很 多 自己 的 逻辑 。 


3.2.2 创建 和 加 载 布局 


前 面 我 们 说 过 ，Android 程 序 的 设计 讲究 逻辑 和 视图 分 离 ， 最 好 每 一 个 Activity 都 能 对 应 一 个 布 
局 。 布 局 是 用 来 显示 界面 内 容 的 ， 我 们 现在 就 来 手动 创建 一 个 布局 文件 。 
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右 击 app/src/main/res 目 录 *New-Directory , 会 弹出 一 个 新 建 目录 的 窗口 ， 这 里 先 创建 一 个 
名 为 layout 的 目录 。 然 后 对 着 layout 目 录 右 键 一 New 一 Layout resource file ,又 会 弹出 一 个 
新 建 布局 资源 文件 的 窗口 ， 我 们 将 这 个 布局 文件 命名 为 first_layout , 根 元 素 默 认 选 择 为 
LinearLayout , 如 图 3.4 所 示 。 


名 @ New Layout Resource File 
File name: first_layout 


Root element: LinearLayout 


Cancel [OK | 
图 3.4 ”新 建 布局 资源 文件 
点 击 “OK” 完 成 布局 的 创建 ， 这 时 候 你 会 看 到 如 图 3.5 所 示 的 布局 编辑 器 。 


堪 first_layoutxml 


Palette QQ 一 i 多- SO | 0pixel- w28 O25% DO @ Atributes Q 号 | 次 一 
Common Ab TextView © 圈 
Text Button 
四 ImageView 
Buttons 
泻 RecyclerView 
Widgets ¢> <fragment> 
Layouts ScrollView 


Containers & “® Switch 
Google 


Legacy 


Component Tree 站 一 


已 LinearLayout 


Design Text 


图 3.5 布局 编辑 器 


这 是 Android Studio 为 我 们 提供 的 可 视 化 布局 编辑 器 ， 你 可 以 在 屏幕 的 中 央 区 域 预览 当前 的 布 
局 。 在 窗口 的 左下 方 有 两 个 切换 卡 : 左边 是 Design , 右边 是 Text。Design 是 当前 的 可 视 化 布局 
编辑 器 ， 在 这 里 你 不 仅 可 以 预览 当前 的 布局 ,还 可 以 通过 拖 放 的 方式 编辑 布局 。 而 Text 则 是 通 
过 XML 文件 的 方式 来 编辑 布局 的 ， 现 在 点 击 一 下 Text 切 换 卡 ， 可 以 看 到 如 下 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


</LinearLayout> 
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由 于 我 们 刚才 在 创建 布局 文件 时 选择 了 LinearLayout 作 为 根 元 素 ， 因 此 现在 布局 文件 中 已 经 有 
一 个 LinearLayout 元 素 了 。 我 们 现在 对 这 个 布局 稍 做 编辑 ， 添 加 一 个 按钮 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button1" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button 1" 

/> 


</LinearLayout> 


这 里 添加 了 一 个 Button 元 素 ， 并 在 Button 元 素 的 内 部 增加 了 几 个 属性 。android:id 是 给 当前 
的 元 素 定义 一 个 唯一 的 标识 符 ， 之 后 可 以 在 代码 中 对 这 个 元 素 进行 操作 。 你 可 能 会 对 
@+id/button1 这 种 语法 感 有 #2 中 陌 生 ，, 但 如 果 把 加 号 去 掉 ， 变 成 Gid/button1 , 你 就 会 觉得 有 些 
熟悉 了 吧 。 这 不 就 是 在 XML 中 引用 资源 的 语法 吗 ? 只 不 过 是 把 string 蔡 换 成 了 id。 是 的 ， 如果 
你 需要 在 XML 中 引用 一 个 id， 就 使 用 Qid/id_name 这 种 语法 ， 而 如 果 你 需要 在 XML 中 定义 一 
个 id， 则 要 使 用 G+id/id name 这 种 语法 。 随 后 android:1layout width 指定 了 当前 元 素 的 
宽度 ， 这 里 使 用 match_parent 表 示 让 当前 元 素 和 父 元 素 一 样 帘 。android:Layout_height 
指定 了 当前 元 素 的 高 度 ， 这 里 使 用 wrap_content 表 示 当 前 元 素 的 高 度 只 要 能 刚好 包含 里 面 的 
内 容 就 行 。android :text 指 定 了 元 素 中 显示 的 文字 内 容 。 如 果 你 还 不 能 完全 看 明白 ， 没 有 关 
系 ， 关 于 编写 布局 的 详细 内 容 我 会 在 下 一 章 中 重点 讲解 ， 本 章 只 是 先 简单 涉及 一 些 。 现 在 按钮 
已 经 添加 完了 ， 你 可 以 通过 右 侧 工具 栏 的 Preview 来 预览 一 下 当前 布局 , 如 图 3.6 所 示 。 


www.blogss.cn 


S. | HS. | 0 Pixel~ 虽 50% 由 加 


Palette 


用 


BUTTON 1 


图 3.6 预览 当前 布局 
可 以 看 到 ， 按钮 已 经 成 功 显 示 出 来 了 ， 这样 一 个 简单 的 布局 就 编写 完成 了 。 那 么 接 下 来 我 们 要 
做 的 ， 就 是 在 Activity 中 加 载 这 个 布局 。 


重新 回 到 FirstActivity , 在 onCreate ( ) 方 法 中 加 入 如 下 代码 : 


class FirstActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.first layout) 


} 
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} 


可 以 看 到 ， 这 里 调用 了 setContentView( ) 方 法 来 给 当前 的 Activity 加 载 一 个 布局 ,而 在 
setContentView() 方 法 中 ， 我 们 一 般 会 传 入 一 个 布局 文件 的 id。 在 第 1 章 介 绍 项 目 资源 的 时 
候 我 曾 提 到 过 ， 项 目 中 添加 的 任何 资源 都 会 在 R 文 件 中 生成 一 个 相应 的 资源 id， 因 此 我 们 刚才 创 
建 的 first_ Layout .xml 布 局 的 id 现 在 已 经 添加 到 R 文 件 中 了 。 在 代码 中 引用 布局 文件 的 方法 
你 也 已 经 学 过 了 ， 只 需要 调用 R. Layout .first Layout 就 可 以 得 有 first layout.xml 布 
局 的 1d， 然 后 将 这 个 值 传 入 setContentView() 方 法 即 可 。 


3.2.3 在 AndroidManifest 文 件 中 注册 
在 第 1 章 我 们 学 过 ， 所 有 的 Activity 都 要 在 AndroidManifest.xml 中 进行 注册 才能 生效 。 实 际 上 


FirstActivity 已 经 在 AndroidManifest.xml 中 注册 过 了 我 们 打开 
app/src/main/AndroidManifest.xml 文 件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.activitytest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=".FirstActivity"> 
</activity> 
</application> 


</manifest> 


可 以 看 到 ，Activity 的 注册 声明 要 放 在 <appLication> 标 签 内 ， 这 里 是 通过 <activity> 标 签 
来 对 Activity 进 行 注册 的 。 那 么 又 是 谁 帮 有 我 们 自动 完成 了 对 FirstActivity 的 注册 呢 ? 当然 是 
Android Studio 了 。 在 过 去 ， 当 创建 Activity 或 其 他 系统 组 件 时 ， 很 多 人 会 喜 记 要 去 Android 
Manifest.xml 中 进行 注册 ， 从 而 导致 程序 运行 月 溃 ， 很 显然 Android Studio 在 这 方面 做 得 更 加 
人 性 化 。 


在 <activity> 标 签 中 ， 我 们 使 用 了 android :name 来 指定 具体 注册 哪 一 个 Activity， 那么 这 
里 填 入 的 .FirstActivity 是 什么 意思 呢 ? 其 实 这 不 过 是 
com.example.activitytest.FirstActivity 的 缩写 而 已 。 由 于 在 最 外 层 的 <manifest> 
标签 中 已 经 通过 package 属 性 指定 了 程序 的 包 名 是 com .example .activitytest , 因此 在 注 
册 Activity 时 ， 这 一 部 分 可 以 省 略 ， 直 接 使 用 . FirstActivity 就 足够 了 。 


不 过 ， 仅 仅 是 这 样 注册 了 Activity ,我们 的 程序 仍然 不 能 运行 ， 因 为 还 没有 为 程序 配置 主 
Activity。 也 就 是 说 ， 程 序 运行 起 来 的 时 候 ， 不 知道 要 首先 启动 哪个 Activity。 配 置 主 Activity 
的 方法 其 实在 第 1 章 中 已 经 介绍 过 了 ， 就 是 在 <activity> 标 签 的 内 部 加 入 <intent-filter> 
标签 ， 并 在 这 个 标签 里 添加 <action 
android:name="android.intent.action.MAIN"/> 和 <category 
android:name="android.intent.category .LAUNCHER"” /> 这 两 名 声明 即 可 。 
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除 此 之 外 ， 我 们 还 可 以 使 用 android :Labet 指 定 Activity 中 标题 栏 的 内 容 ， 标 题 栏 是 显示 在 
Activity 最 顶部 的 ， 待 会 儿 运 行 的 时 候 你 就 会 看 到 。 需 要 注意 的 是 ,给 主 Activity 指 定 的 label 不 
仅 会 成 为 标题 栏 中 的 内 容 ， 还 会 成 为 启动 器 (Launcher) 中 应 用 程序 显示 的 名 称 。 


修改 后 的 AndroidManifest.xml 文 件 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.activitytest"> 


<application 
i 
<activity android:name=".FirstActivity" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android,.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 


</intent-filter> 
</activity> 
</application> 


</manifest> 

这 样 ，FirstActivity 就 成 为 我 们 这 个 程序 的 主 Activity 了 ,点击 桌面 应 用 程序 图 标 时 首先 打开 的 
就 是 这 个 Activity。 另 外 需要 注意 ， 如 果 你 的 应 用 程序 中 没有 声明 任何 一 个 Activity 作 为 主 
Activity， 这 个 程序 仍然 是 可 以 正常 安装 的 ,只 是 你 无 法 在 局 动 右 中 看 到 或 者 打开 这 个 程序 。 
种 程序 一 般 是 作为 第 三 方 服 务 供 其 他 应 用 在 内 部 进行 调用 的 。 


~ 


这 


yd 


好 了 ， 现在 一 切 都 已 准备 就 绪 ， 让 我 们 来 运行 一 下 程序 吧 ， 结 果 如 图 3.7 所 示 。 
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9:23 


This is FirstActivity 


BUTTON 1 


图 3.7 首次 运行 结果 


在 界面 的 最 顶部 是 一 个 标题 栏 ， 里 面 显示 着 我 们 刚才 在 注册 Activity 时 指定 的 内 容 。 标 题 栏 的 下 
面 就 是 在 布局 文件 first_layout.xml 中 编写 的 界面 ， 可 以 看 到 我 们 刚刚 定义 的 按钮 。 现 在 你 已 经 
成 功 掌握 了 手动 创建 Activity 的 方法 ， 下 面 让 我 们 继续 看 一 看 你 在 Activity 中 还 能 做 哪些 事情 
吧 。 


3.2.4 在 Activity 中 使 用 Toast 

Toast 是 Android 系 统 提供 的 一 种 非常 好 的 提醒 方式 ， 在 程序 中 可 以 使 用 它 将 一 些 短小 的 信息 通 
知 给 用 户 ， 这 些 信息 会 在 一 段 时 间 后 自动 消失 ， 并 且 不 会 占用 任何 屏幕 空间 ,我 们 现在 就 尝试 
一 下 如 何在 Activity 中 使 用 Toast。 


首先 需要 定义 一 个 弹出 Toast 的 触发 点 ,正好 界面 上 有 个 按钮 ， 那 我 们 就 让 这 个 按钮 的 点 击 事件 
作为 弹出 Toast 的 触发 点 吧 。 在 onCreate ( ) 方 法 中 添加 如 下 代码 : 
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override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.first layout) 
val buttonl: Button = findViewById(R.id.button1) 
buttonl.setOnClickListener { 
Toast.makeText(this, "You clicked Button 1", Toast.LENGTH SHORT).show() 
} 


} 


在 Activity 中 ,可 以 通过 findViewById ( ) 方 法 获取 在 布局 文件 中 定义 的 元 素 ， 这 里 我 们 传 入 
R.id.button1 来 得 到 按钮 的 实例 ， 这 个 值 是 刚才 在 first_ layout.xml 中 通过 android:id 属 
性 指定 的 。findViewById ( ) 方 法 返回 的 是 一 个 继承 自 View 的 泛 型 对 象 ， 因 此 Kotlin 无 法 自动 
推导 出 它 是 一 个 Button 还 是 其 他 控件 ， 所 以 我 们 需要 将 button1 变 量 显 式 地 声明 成 Button 类 
型 。 得 到 按钮 的 实例 之 后 ， 我 们 通过 调用 set0nCLickListener () 方 法 为 按钮 注册 一 个 监听 
器 , 点 击 按钮 时 就 会 执行 监听 器 中 的 onCLick ( ) 方 法 。 因 此 ,弹出 Toast 的 功能 当然 是 要 在 
onClick() 方 法 中 编写 了 。 


Toast 的 用 法 非常 简单 ， 通 过 静态 方法 makeText ( ) 创 建 出 一 个 Toast 对 象 ， 然 后 调用 show() 
将 Toast 显 示 出 来 就 可 以 了 。 这 里 需要 注意 的 是 ， makeText ( ) 方 法 需要 传 入 3 个 参数 。 第 一 个 
参数 是 Context， 也 就 是 Toast 要 求 的 上 下 文 ， 由 于 Activity 本 身 就 是 一 个 Context 对 象 ， 因 此 
这 里 直接 传 和 this 即 可 。 第 二 个 参数 是 Toast 显 示 的 文本 内 容 。 第 三 个 参数 是 Toast 显 示 的 时 
长 ， 有 两 个 内 置 常 量 可 以 选择 : Toast .LENGTH_ SHORT 和 Toast.LENGTH_ LONG。 


现在 重新 运行 程序 ， 并 点 击 一 下 按钮 ， 效果 如 图 3.8 所 示 。 
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9:23 4 自 


This is FirstActivity 


BUTTON 1 


You clicked Button 1 


图 3.8 Toast 运 行 效果 


关于 findViewById () 方 法 的 使 用 ,我 还 得 再 多 讲 一些 。 我 们 已 经 知道 ,findViewById () 方 
法 的 作用 就 是 获取 布局 文件 中 控件 的 实例 ,但 是 前 面 的 例子 比较 简单 ， 只 有 一 个 按钮 ， 如 果 某 
个 布局 文件 中 有 10 个 控件 呢 ? 没 错 ,我 们 就 需要 调用 10 次 findViewById () 方 法 才 行 。 这 种 
写法 虽然 很 正确 ,但 是 很 笨拙 ， 于 是 就 滋生 出 了 诸如 ButterKnife 之 类 的 第 三 方 开源 库 ， 来 简化 
findViewById () 方 法 的 调用 。 


不 过 ,这 个 问题 在 Kotlin 中 就 不 复 存 在 了 ， 因 为 使 用 Kotlin 编 写 的 Android 项 目 在 
app/build.gradle 文 件 的 头 部 默认 引入 了 一 个 kotlin-android-extensions 插 件 ， 这 个 插件 会 根 
据 布局 文件 中 定义 的 控件 id 自动 生成 一 个 具有 相同 名 称 的 变量 ， 我们 可 以 在 Activity 里 直接 使 用 
这 个 变量 ， 而 不 用 再 调用 findViewById ( ) 方 法 了 ， 如 图 3.9 所 示 。 
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class FirstActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R. layout, first_layout) 
buttond| 
button1l from first_layout.xml for Activity (Android Ex. Buttone。 
Press 人 .to choose the selected (or first) suggestion and insert a dot afterwards >> 


图 3.9 ”调用 自动 生成 的 button1 变 量 


这 里 我 仍然 建议 你 使 用 上 一 章 中 介绍 的 Android Studio 代 码 补 全 功能 ， 因 为 自动 生成 的 这 些 变 
量 也 是 需要 导 包 的 。 


现在 我 们 就 可 以 进一步 简化 代码 了 ， 如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.first layout) 
buttonl.setOnClickListener { 
Toast.makeText(this, "You clicked Button 1", Toast.LENGTH SHORT).show() 
} 


} 
可 以 看 到 ， 这 样 就 不 用 再 调用 findViewById() 方 法 了 。 


这 种 写法 其 实 是 Kotlin 编 程 最 推荐 的 写法 ， 除 非特 殊 情 况 ， 本 书后 面 将 尽量 不 再 使 用 
findViewById( ) 方 法 ,而 是 会 直接 调用 这 些 自动 生成 的 控件 变量 。 当 然 ， 即 使 你 以 后 很 少 会 
用 到 findViewById ( ) 方 法 ， 我 们 还 是 得 了 解 它 才 行 ， 因 为 kotlin-android-extensions 这 个 
插件 背后 也 是 通过 调用 findViewById ( ) 方 法 来 实现 的 。 


3.2.5 在 Activity 中 使 用 Menu 


手机 毕竟 和 电脑 不 同 ， 它 的 屏幕 空间 非常 有 限 ， 因 此 充分 地 利用 屏幕 空间 在 手机 界面 设计 中 就 
显得 非常 重要 了 。 如 果 你 的 Activity 中 有 大 量 的 菜单 需要 显示 ， 界面 设计 就 会 比较 尴 众 ， 因 为 仅 
这 些 菜 单 就 可 能 占用 将 近 三 分 之 一 的 屏幕 空间 ， 这 该 怎么 办 呢 ?不 用 担心 ,Android 给 我 们 提供 
了 一 种 方式 ， 可 以 让 菜单 都 能 得 到 展示 ， 还 不 占用 任何 屏幕 空间 。 


首先 在 res 目 录 下 新 建 一 个 menu 文 件 夹 ， 右 击 res 目 录 一 New 一 Directory , 输入 文件 夹 
名 “menu”, 点 击 “OK”。 接 着 在 这 个 文件 夹 下 新 建 一 个 名 叫 “main” 的 菜单 文件 ，, 右 击 menu 文 
件 夹 New 一 Menu resource file , 如 图 3.10 所 示 。 


(2) E33 New Menu Resource File 
Enter a new file name 
和 main | 
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图 3.10 ”新 建 Menu 资 源 文件 
文件 名 输入 “main”, 点 击 “OK" 完 成 创建 ， 然 后 在 main.xml 中 添加 如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<item 
android:id="@+id/add item" 
android:title="Add"/> 
<item 
android:id="@+id/remove item" 
android:title="Remove"/> 
</menu> 


这 里 我 们 创建 了 两 个 菜单 项 ， ly tn ne , 然后 通过 
android:id 给 这 个 菜单 项 指定 一 个 唯一 的 标识 符 ， 通过 android:title 给 这 个 菜单 项 指定 一 
个 名 称 。 


接着 回 到 FirstActivity 中 来 重 写 onCreate0ptionsMenu( ) 方 法 ， 重 写 方法 可 以 使 用 Ctrl + O 
快捷 键 (Mac 系 统 是 control + O) ， 如 图 3.11 所 示 。 


© @ Override Members 
I 三 二 

m Hs onNavigateUpFromChild(child: Activity!): Boolean 
m » getReferrer(): Uri! 
m ws startLocalVoicelnteraction (privateOptions: Bundle!): Unit 
m sb setRequestedOrientation (requestedOrientation: Int): Unit 
而 也 dispatchPopulateAccessibilityEvent(event: AccessibilityEvt 
m s reportFullyDrawn(): Unit 


onCreateOptionsMenu(menu: Menu!): Boolean 


5 startPostponedEnterTransition(): Unit 
getLoaderManager(): LoaderManager! 

5 isActivityTransitionRunning(): Boolean 

5 unregisterForContextMenu(view: View!): Unit 

5 overridePendingTransition(enterAnim: Int, exitAnim: Int): UL 


onGenericMotinnFventfevent+ MantinnFventl): RAanlean 


L] Copy JavaDoc Cancel Select None ON | 


图 3.11 重 写 onCreate0ptionsMenu ( ) 方 法 


DOOGOOOEE 


然后 在 onCreate0ptionsMenu() 方 法 中 编写 如 下 代码 : 


override fun onCreate0ptionsMenu(menu: Menu?): Boolean { 
menuInflater.inflate(R.menu.main, menu) 
return true 


在 继 0 , 我 还 得 再 介绍 一 个 Kotlin 的 语法 糖 。 如 果 你 熟悉 Java 的 话 ， 应 该 知道 
Java Bean 的 概念 ， 它 是 一 个 非常 ， , 会 根据 类 中 的 字段 自动 生成 相应 的 Getter 和 


Setter 方 法 ， 如 下 启示 : 
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public class Book { 
private int pages; 
public int getPages() { 


return pages ; 


public void setPages(int pages) { 
this.pages = pages; 


} 


在 Kotlin 中 调用 这 种 语法 结构 的 Java 方 法 时 ， 可 以 使 用 一 种 更 加 简便 的 写法 ， 比 如 用 如 下 代码 来 
设置 和 读 取 Book 类 中 的 pages 字 段 : 


val book = Book() 
book.pages = 500 
val bookPages = book.pages 


这 里 看 上 去 好 像 我 们 并 没有 调用 Book 类 的 setPages () 和 getPages() 方 法 , 而 是 直接 对 
pages 字 段 进行 了 赋值 和 读 取 。 其 实 这 就 是 Kotlin 给 我 们 提供 的 语法 糖 ， 它 会 在 背后 自动 将 上 述 
代码 转换 成 调用 setPages ( ) 方 法 和 getPages ( ) 方 法 。 


而 我 们 刚才 在 onCreate0ptionsMenu () 方 法 中 编写 的 nenuInfLater 就 使 用 了 这 种 语法 糖 ， 
它 实 际 上 是 调用 了 父 类 的 getMenuInfLater() 方 法 。getMenuInfLater( ) 方 法 能 够 得 到 一 
个 MenuInfLater 对 象 ， 再 调用 它 的 infLate( ) 方 法 ， 就 可 以 给 当前 Activity 创 建 菜单 了 。 
inftLate ( ) 方 法 接收 两 个 参数 : 第 一 个 参数 用 于 指定 我 们 通过 哪 一 个 资源 文件 来 创建 菜单 ， 这 
里 当然 是 传 和 R,menu ,main ; 第 二 个 参数 用 于 指定 我 们 的 菜单 项 将 添加 到 哪 一 个 Menu 对 象 当 
中 ,这 里 直接 使 用 onCreate0ptionsMenu ( ) 方 法 中 传 入 的 menu 参 数 。 最 后 给 这 个 方法 返回 
true ,表示 人 允许 创建 的 菜单 显示 出 来 ， 如 果 返 回 了 false ，, 创建 的 菜单 将 无 法 显示 。 


当然 ， 仅 仅 让 菜单 显示 出 来 是 不 够 的 ， 我 们 定义 菜单 不 仅 是 为 了 看 的 ， 关 键 是 要 菜单 真正 可 用 
才 行 ， 因 此 还 要 再 定义 菜单 响应 事件 。 在 FirstActivity 中 重 写 on0ptionsItemSetLected () 方 
法 ， 如 下 所 示 : 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
when (item.itemId) { 
R.id.add item -> Toast.makeText(this, "You clicked Add", 
Toast .LENGTH SHORT) .show'() 
R.id.remove item -> Toast.makeText(this, "You clicked Remove", 
Toast .LENGTH SHORT) .show'() 


return true 


} 


在 on0ptionsItemSelected() 方 法 中 ，, 我们 通过 调用 item.itemId 来 判断 点 击 的 是 哪 一 个 
菜单 项 。 另 外 ， 其 实 这 里 也 应 用 了 刚刚 学 到 的 语法 糖 ，Kotlin 实 际 上 在 背后 调用 的 是 item 的 
getItemId() 方 法 。 接 下 来 我 们 将 item.itemId 的 结果 传 入 when 语 名 当中 ， 然 后 给 每 个 菜单 
项 加 入 自己 的 逻辑 处 理 ， 这 里 我 们 就 活 学 活用 ， 弹出 一 个 刚刚 学 会 的 Toast。 
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重新 运行 程序 ,你 会 发 现在 标题 栏 的 右 侧 多 了 一 个 三 点 的 符号 ， 这 个 就 是 菜单 按钮 了 ， 如 图 
3.12 所 示 。 


9:24 


This is FirstActivity 


BUTTON1 


图 3.12 带 菜 单 按钮 的 Activity 


可 以 看 到 ， 菜单 里 的 菜单 项 默认 是 不 显示 的 ， 只 有 点 击 菜 单 按钮 才 会 弹出 里 面具 体 的 内 容 ， 
此 它 不 会 占用 任何 Activity 的 空间 ,如 图 3.13 所 示 。 


www.blogss.cn 


9:24 


This is FirstActivity Add 


BUTT( Remove 


图 3.13 弹出 菜单 项 的 界面 


如 果 你 点 击 了 Add 菜 单项 ， 就 会 弹出 You clicked Add 提 示 (如 图 3.14 所 示 ) :; 如 果 点 击 了 
Remove 菜 单项 ， 就 会 弹出 You clicked Remove 提 示 。 
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This is FirstActivity 


BUTTON1 


You clicked Add 


图 3.14 ”点击 了 Add 菜 单项 
3.2.6 销毁 一 个 Activity 


通过 上 一 节 的 学 习 ， 你 已 经 掌握 了 手动 创建 Activity 的 方法 ， 并 学 会 了 如 何在 Activity 中 创建 
Toast 和 菜单 。 或 许 你 现在 心中 会 有 个 疑惑 : 如 何 销毁 一 个 Activity 呢 ? 

其 实 答案 非常 简单 ， 只 要 按 一 下 Back 键 就 可 以 销毁 当前 的 Activity 了 。 不 过 ， 如 果 你 不 想 通过 
按键 的 方式 ， 而 是 希望 在 程序 中 通过 代码 来 销毁 Activity， 当 然 也 可 以 ，Activity 类 提供 了 一 个 
finish( ) 方 法 ， 我 们 只 需要 调用 一 下 这 个 方法 就 可 以 销毁 当前 的 Activity 了 。 


修改 按钮 监听 钴 中 的 代码 ， 如 下 所 示 : 


buttonl.setOnClickListener { 
finish() 


重新 运行 程序 , 这 时 点 击 一 下 按钮 ， 当 前 的 Activity 就 被 成 功 销毁 了 ， 效 果 和 按 下 Back 键 是 一 
样 的 。 
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3.3 ”使 用 Intent 在 Activity 之 间 穿 梭 


只 有 一 个 Activity 的 应 用 也 太 简单 了 吧 ? 没 错 ， 你 的 追求 应 该 更 高 一 点 。 不 管 你 想 创建 多 少 个 
Activity ,方法 都 和 上 一 节 中 介绍 的 是 一 样 的 。 唯 一 的 问题 在 于 ， 你 在 启动 硕 中 点 击 应 用 的 图 标 
只 会 进入 该 应 用 的 主 Activity， 那么 怎样 才能 由 主 Activity 跳 转 到 其 他 Activity 呢 ? 我 们 现在 就 
一 起 来 看 一 看 。 


3.3.1 使 用 显 式 Intent 


你 应 该 已 经 对 创建 Activity 的 流程 比较 熟悉 了 ， 那 我 们 现在 在 ActivityTest 项 目 中 再 快速 地 创建 
一 个 Activity。 


还 是 右 击 com.example.activitytest 包 New 一 ActivityEmpty Activity , 会 弹出 一 个 创建 
Activity 的 对 话 框 ， 这 次 我 们 命名 为 SecondActivity， 并 勾 选 Generate Layout File ,给 布局 
文件 起 名 为 second_layout , 但 不 要 勾 选 Launcher Activity 选 项 ， 如 图 3.15 所 示 。 


@ 全 New Android Activity 


Configure Activity L 


/以 Android Studio 


Creates a new empty activity 


Activity Name: SecondActivity 
Generate Layout File 
Layout Name: second_layout 


Launcher Activity 


Backwards Compatibility (AppCompat) 


Package name: com.example.activitytest 
Source Language: Kotlin 4 


图 3.15 创建 SecondActivity 


点 击 “Finish” 完 成 创建 ，Android Studio 会 为 我 们 自动 生成 SecondActivity.kt 和 
second_layout.xml 这 两 个 文件 。 不 过 自动 生成 的 布局 代码 目前 对 你 来 说 可 能 有 些 难以 理解 ， 
这 里 我 们 还 是 使 用 比较 熟悉 的 LinearLayout , 编辑 second_layout.xml , 将 里 面 的 代码 替换 成 
如 下 内 容 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button2" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button 2" 

/> 


</LinearLayout> 
我 们 还 是 定义 了 一 个 按钮 ， 并 在 按钮 上 显示 Button 2。 
SecondActivity 中 的 代码 已 经 自动 生成 了 一 部 分 ， 我 们 保持 默认 不 变 即 可 ， 如 下 所 示 : 


class SecondActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


super.onCreate(savedInstanceState) 
setContentView(R.layout.second layout) 


} 


另外 不 要 忘记 ， 任 何 一 个 Activity 都 是 需要 在 AndroidManifest.xml 中 注册 的 。 不 过 幸运 的 
是 ,Android Studio 已 经 帮 有 我 们 自动 完成 了 ， 你 可 以 打开 AndroidManifest.xml 瞧 一 瞧 : 


<application 
> 


<activity android:name=".SecondActivity"> 
</activity> 
<activity 
android:name=" .FirstActivity" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN"/> 
<category android:name="android.intent.category.LAUNCHER"/> 
</intent-filter> 
</activity> 
</application> 


由 于 SecondActivity 不 是 主 Activity , 因此 不 需要 配置 <intent -fiLter> 标 签 里 的 内 容 , 注 
册 Activity 的 代码 也 简单 了 许多 。 现 在 第 二 个 Activity 已 经 创建 完成 ， 剩 下 的 问题 就 是 如 何 去 启 
动 它 了 ， 这 里 我 们 需要 引入 一 个 新 的 概念 : Intent。 


Intent 是 Android 程 序 中 各 组 件 之 间 进 行 交 互 的 一 种 重要 方式 ， 它 不 仅 可 以 指明 当前 组 件 想 要 执 
行 的 动作 ， 还 可 以 在 不 同 组 件 之 间 传 递 数据 。Intent 一 般 可 用 于 启动 Activity、 启 动 Service 以 
及 发 送 广 播 等 场景 ， 由 于 Service、 广 播 等 概念 你 暂时 还 未 涉及 ， 那 么 本 章 我 们 的 目光 无 疑 就 锁 
定 在 了 启动 Activity 上 面 。 


Intent 大 致 可 以 分 为 两 种 : 显 式 Intent 和 隐 式 Intent。 我 们 先 来 看 一 下 显 式 Intent 如 何 使 用 。 
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Intent 有 多 个 构造 滑 数 的 重 载 ， 其 中 一 个 是 Intent (Context packageContext, Class<? 
> cls)。 这 个 构造 浮 数 接收 两 个 参数 : 第 一 个 参数 Context 要 求 提 供 一 个 启动 Activity 的 上 下 
文 ; 第 二 个 参数 Class 用 于 指定 想 要 局 动 的 目标 Activity ,通过 这 个 构造 水 数 就 可 以 构建 出 
Intent 的 “意图 "。 那 么 接 下 来 我 们 应 该 怎么 使 用 这 个 Intent 呢 ? Activity 类 中 提供 了 一 个 
startActivity() 方 法 ,专门 用 于 启动 Activity , 它 接收 一 个 Intent 参 数 ， 这 里 我 们 将 构建 好 
的 Intent 传 入 startActivity() 方 法 就 可 以 启动 目标 Activity 了 。 


修改 FirstActivity 中 按钮 的 点 击 事 件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener { 
val intent = Intent(this, SecondActivity::class.java) 
startActivity(intent) 

} 


我 们 首先 构建 了 一 个 Intent 对 象 ， 第 一 个 参数 传 入 this 也 就 是 FirstActivity 作 为 上 下 文 ， 第 二 
个 参数 传 入 SecondActivity: :class.java 作 为 目标 Activity , 这样 我 们 的 “意图 "就 非常 明 
显 了 ， 即 在 FirstActivity 的 基础 上 打开 SecondActivity。 注 意 ，Kotlin 中 
SecondActivity::cLass.java 的 写法 就 相当 于 Java 中 SecondActivity.cLass 的 写法 。 
接 下 来 再 通过 startActivity() 方 法 执行 这 个 Intent 就 可 以 了 。 


重新 运行 程序 , 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 3.16 所 示 。 
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9:26 4 自 


ActivityTest 


BUTTON 2 


图 3.16 SecondActivity 界 面 


可 以 看 到 , 我们 已 经 成 功 启动 SecondActivity 了 。 如 果 你 想 要 回 到 上 一 个 Activity 怎 么 办 呢 ? 
很 简单 ， 按 一 下 Back 键 就 可 以 销毁 当前 Activity， 从 而 回 到 上 一 个 Activity 了 。 


使 用 这 种 方式 来 启动 Activity， Intent 的 “意图 "非常 明显 ， 因 此 我 们 称 之 为 显 式 Intent。 
3.3.2 使 用 隐 式 Intent 


相 比 于 显 式 Intent , 隐 式 Intent 则 含 著 了 许多 ， 它 并 不 明确 指出 想 要 启动 哪 一 个 Activity , 而 是 
指定 了 一 系列 更 为 抽象 的 action 和 category 等 信息 ， 然 后 交 由 系统 去 分 析 这 个 Intent， 并 帮 
我 们 找 出 合适 的 Activity 去 启动 。 


什么 叫 作 合适 的 Activity 呢 ? 简单 来 说 就 是 可 以 响应 这 个 隐 式 Intent 的 Activity， 那么 目前 
SecondActivity 可 以 响应 什么 样 的 隐 式 Intent 呢 ? 额 ， 现 在 好 像 还 什么 都 响应 不 了 ,不 过 很 快 


www.blogss.cn 


就 可 以 了 。 


通过 在 <activity> 标 签 下 配置 <intent -fiLter> 的 内 容 , 可 以 指定 当前 Activity 能 够 响应 的 
action 和 category , 打开 AndroidManifest.xml , 添加 如 下 代码 : 


<activity android:name=" ,9econdActivity”> 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
</intent-filter> 
</activity> 


在 <action> 标 签 中 我 们 指明 了 当前 Activity 可 以 响应 
com.example.activitytest.ACTION START 这 个 action , 而 <category> 标 签 则 包含 了 
一 些 附加 信息 ， 更 精确 地 指明 了 当前 Activity 能 够 响应 的 Intent 中 还 可 能 带 有 的 Category。 只 
有 <action> 和 <category> 中 的 内 容 同 时 匹配 Intent 中 指定 的 action 和 category 时 ,这 个 
Activity 才 能 响应 该 Intent。 


修改 FirstActivity 中 按钮 的 点 击 事件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener { 
val intent = Intent("com.example.activitytest.ACTION START") 
startActivity(intent) 


可 以 看 到 ， 我 们 使 用 了 Intent 的 另 一 个 构造 永 数 ， 直 接 将 action 的 字符 串 传 了 进去 ， 表 明 我 们 
想 要 局 动能 够 响应 com ,exampLe .activitytest.ACTION START 这 个 action 的 Activity。 
前 面 不 是 说 要 <action> 和 <category> 同 时 匹配 才能 响应 吗 ? 怎么 没 看 到 哪里 有 指定 
category 呢 ?这 是 因为 android.intent.category .DEFAULT 是 一 种 默认 的 category ， 
在 调用 startActivity() 方 法 的 时 候 会 自动 将 这 个 category 添 加 到 Intent 中 。 


重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ,你 同样 成 功 启动 SecondActivity 了 。 不 
同 的 是 ， 这 次 你 是 使 用 隐 式 Intent 的 方式 来 启动 的 ， 说 明 我 们 在 <activity> 标 签 下 配置 的 
action 和 category 的 内 容 已 经 生效 了 ! 


每 个 Intent 中 只 能 指定 一 个 action , 但 能 指定 多 个 category。 目 前 我 们 的 Intent 中 只 有 一 个 
默认 的 category , 那么 现在 再 来 增加 一 个 吧 。 


修改 FirstActivity 中 按钮 的 点 击 事 件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener { 
val intent = Intent("com.example.activitytest.ACTION START") 
intent.addCategory("com.example.activitytest.MY CATEGORY") 
startActivity(intent) 

} 


可 以 调用 Intent 中 的 addCategory () 方 法 来 添加 一 个 category , 这 里 我 们 指定 了 一 个 自 定义 
的 category , 值 为 com.example.activitytest.MY CATEGORY。 
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现在 重新 运行 程序 ， 在 FirstActivity 的 界面 点 击 一 下 按钮 ,你 会 发 现 ， 程序 裔 演 了 ! 这 是 你 第 一 
次 遇 到 程序 裔 演 ， 可 能 会 有 些 束 手 无 策 。 别 紧张 ， 只 要 你 善于 分 析 ， 其实 大 多 数 的 裔 溃 问 题 很 
好 解决 。 在 Logcat 界 面 查看 错误 日 志 ， 你 会 看 到 如 图 3.17 所 示 的 错误 信息 。 


Process: com. example.activitytest, PID: 24027 
android. content. ActivityNotFomdException: No Activity found to handle Intent { 
act=com. example. activitytest. ACTION_START cat=[com. example. activitytest. MY_CATEGORY] } 


图 3.17 错误 信息 


错误 信息 提醒 我 们 ,没有 任何 一 个 Activity 可 以 响应 我 们 的 Intent。 这 是 因为 我 们 刚刚 在 Intent 
中 新 增 了 一 个 category , 而 SecondActivity 的 <intent -fiLter> 标 签 中 并 没有 声明 可 以 响 
应 这 个 category， 所 以 就 出 现 了 没有 任何 Activity 可 以 响应 该 Intent 的 情况 。 现 在 我 们 在 
<intent-fiLter> 中 再 添加 一 个 category 的 声明 , 如 下 所 示 : 


<activity android:name=".SecondActivity" > 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY CATEGORY"/> 
</intent-filter> 
</activity> 


再 次 重新 运行 程序 ,你 就 会 发 现 一 切 都 正常 了 。 
3.3.3 更 多 隐 式 Intent 的 用 法 


上 一 节 中 ， 你 掌握 了 通过 隐 式 Intent 来 启动 Activity 的 方法 ,但 实际 上 隐 式 Intent 还 有 更 多 的 内 
容 需 要 你 去 了 解 ， 本 节 我 们 就 来 展开 介绍 一 下 。 


使 用 隐 式 Intent ,不仅 可 以 启动 自己 程序 内 的 Activity， 还 可 以 启动 其 他 程序 的 Activity， 这 就 
使 多 个 应 用 程序 之 间 的 功能 共享 成 为 了 可 能 。 比 如 你 的 应 用 程序 中 需要 展示 一 个 网 页 ,这 时 你 
没有 必要 自己 去 实现 一 个 浏览 右 (事实 上 也 不 太 可 能 ) ， 只 需要 调用 系统 的 浏览 右 来 打开 这 个 
网 页 就 行 了 。 


修改 FirstActivity 中 按钮 点 击 事件 的 代码 ， 如 下 所 示 : 


buttonl.setOnClickListener { 
val intent = Intent(Intent.ACTION VIEW) 


intent.data = Uri.parse("https://www.baidu.com") 
startActivity(intent) 


} 


这 里 我 们 首先 指定 了 Intent 的 action 是 Intent .ACTION _VIEW , 这 是 一 个 Android 系 统 内 置 
的 动作 ， 其 常量 值 为 android.intent.action.VIEW。 然 后 通过 Uri .parse() 方 法 将 一 个 
网 址 字符 串 解析 成 一 个 Uri 对 象 ， 再 调用 Intent 的 SetData ( ) 方 法 将 这 个 Uri 对 象 传递 进去 。 
当然 ， 这 里 再 次 使 用 了 前 面 学 习 的 语法 糖 ， 看 上 去 像 是 给 Intent 的 data 属 性 赋值 一 样 。 


重新 运行 程序 , 在 FirstActivity 界 面 点 击 按钮 就 可 以 看 到 打开 了 系统 浏览 器 ， 如 图 3.18 所 示 。 
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图 3.18 系统 浏览 器 界面 


在 上 述 代码 中 ， 可 能 你 会 对 setData( ) 方 法 部 分 感到 陌生 ， 这 是 我 们 前 面 没有 讲 到 的 。 这 个 方 
法 其 实 并 不 复杂 ， 它 接收 一 个 Uri 对 象 ， 主 要 用 于 指定 当前 Intent 正 在 操作 的 数据 ， 而 这 些 数据 
通常 是 以 字符 串 形式 传 入 Uri .parse() 方 法 中 解析 产生 的 。 


与 此 对 应 ， 我 们 还 可 以 在 <intent- fiLter> 标 签 中 再 配置 一 个 <data> 标 签 ， 用 于 更 精确 地 指 
定 当前 Activity 能 够 响应 的 数据 。<data> 标 签 中 主要 可 以 配置 以 下 内 容 。 


android:scheme。 用 于 指定 数据 的 协议 部 分 , 如 上 例 中 的 https 部 分 。 
android:host。 用 于 指定 数据 的 主机 名 部 分 , 如 上 例 中 的 www.baidu.com 部 分 。 
android:port。 用 于 指定 数据 的 端口 部 分 ， 一 般 紧 随 在 主机 名 之 后 。 

android:path。 用 于 指定 主机 名 和 端口 之 后 的 部 分 ， 如 一 段 网 址 中 跟 在 域名 之 后 的 内 
容 。 

。android:mimeType。 用 于 指定 可 以 处 理 的 数据 类 型 ， 人 允许 使 用 通配符 的 方式 进行 指定 。 


只 有 当 <data> 标 签 中 指定 的 内 容 和 Intent 中 携带 的 Data 完 全 一 致 时 ， 当前 Activity 才 能 够 响应 
该 Intent。 不 过 ， 在 <data> 标 签 中 一 般 不 会 指定 过 多 的 内 容 。 例 如 在 上 面 的 浏览 右 示 例 中 ， 其 
实 只 需要 指定 android:scheme 为 https ,就 可 以 响应 所 有 https 协 议 的 Intent 了 。 


为 了 让 你 能 够 更 加 直观 地 理解 ， 我 们 来 自己 建立 一 个 Activity， 让 它 也 能 响应 打开 网 页 的 


Intent, 
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右 击 com,example.activitytest 包 一 New-Activity 一 Empty Activity， 新 建 ThirdActivity ， 
并 勾 选 Generate Layout File， 给 布局 文件 起 名 为 third_layout ,点 击 “Finish” 完 成 创建 。 然 
后 编辑 third_layout.xml , 将 里 面 的 代码 替换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button3" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button 3" 

/> 


</LinearLayout> 


ThirdActivity 中 的 代码 保持 不 变 即 可 ， 最 后 在 AndroidManifest.xml 中 修改 ThirdActivity 的 注 
册 信 息 : 


<activity android:name=" ,ThirdActivity"> 
<intent-filter tools:ignore="AppLinkUrlError"> 
<action android:name="android.intent.action.VIEW" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<data android:scheme="https" /> 
</intent-filter> 
</activity> 


我 们 在 ThirdActivity 的 <intent-filter> 中 配置 了 当前 Activity 能 够 响应 的 action 是 
Intent .ACTION VIEW 的 常量 值 , 而 category 则 毫 无 疑问 地 指定 了 默认 的 category 值 , 另 
外 在 <data> 标 签 中 ， 我们 通过 android ;scheme 指定 了 数据 的 协议 必须 是 https 协 议 ， 这 样 
ThirdActivity 应 该 就 和 浏览 器 一 样 ， 能 够 响应 一 个 打开 网 页 的 Intent 了 。 另 外 , 由 于 Android 
Studio 认 为 所 有 能 够 响应 ACTION VIEW 的 Activity 都 应 该 加 上 BROWSABLE 的 category , 否 
则 就 会 给 出 一 段 警告 提醒 。 加 上 BROWSABLE 的 category 是 为 了 实现 deep link 功 能 ， 和 我 们 
目前 学 习 的 东西 无 关 ， 所 以 这 里 直接 在 <intent -filter> 标 签 上 使 用 tools :1igno re 属性 将 
警告 忽略 即 可 。 


现在 让 我 们 运行 一 下 程序 试 试 吧 , 在 FirstActivity 的 界面 点 击 一 下 按钮 ， 结 果 如 图 3.19 所 示 。 
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图 3.19 ”选择 响应 Intent 的 程序 


可 以 看 到 ， 系统 自动 弹出 了 一 个 列表 ,显示 了 目前 能 够 响应 这 个 Intent 的 所 有 程序 。 选 择 
Chrome 还 会 像 之 前 一 样 打开 浏览 器 ， 并 显示 百度 的 主页 ， 而 如 果 选 择 了 ActivityTest， 则 会 启 
动 ThirdActivity。JUST ONCE 表 示 只 是 这 次 使 用 选择 的 程序 打开 ，ALWAYS 则 表示 以 后 一 直 使 
用 这 次 选择 的 程序 打开 。 需 要 注意 的 是 ， 虽 然 我 们 声明 了 ThirdActivity 是 可 以 响应 打开 网 页 的 
Intent 的 ， 但 实际 上 这 个 Activity 并 没有 加 载 并 显示 网 页 的 功能 ， 所 以 在 真正 的 项 目 中 尽量 不 要 
出 现 这 种 有 可 能 误导 用 户 的 行为 ， 不 然 会 让 用 户 对 我 们 的 应 用 产生 负面 的 印象 。 


除了 https 协 议 外 ， 我 们 还 可 以 指定 很 多 其 他 协议 ， 比 如 geo 表 示 显 示 地 理 位 置 、tel 表 示 拨 打 电 
话 。 下 面 的 代码 展示 了 如 何在 我 们 的 程序 中 调用 系统 拨号 界面 。 


buttonl.setOnClickListener { 
val intent = Intent(Intent.ACTION DIAL) 
intent.data = Uri.parse("tel:10086") 
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startActivity(intent) 
} 


首先 指定 了 Intent 的 action 是 Intent.ACTION _DIAL , 这 又 是 一 个 Android 系 统 的 内 置 动 
作 。 然 后 在 data 部 分 指定 了 协议 是 tel , 号 码 是 10086。 重 新 运行 一 下 程序 ， 在 FirstActivity 
的 界面 点 击 一 下 按钮 ， 结果 如 图 3.20 所 示 。 
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图 3.20 ”系统 拨号 界面 
3.3.4 向 下 一 个 Activity 传 递 数据 
经 过 前 面 几 节 的 学 习 ， 你 已 经 对 Intent 有 了 一 定 的 了 解 。 不 过 到 目前 为 止 ， 我 们 只 是 简单 地 使 


用 Intent 来 局 动 一 个 Activity ,其 实 Intent 在 局 动 Activity 的 时 候 还 可 以 传递 数据 ， 下面 我 们 来 
一 起 看 一 下 。 
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在 启动 Activity 时 传递 数据 的 思路 很 简单 ，Intent 中 提供 了 一 系列 putExtra( ) 方 法 的 重 载 ， 可 
以 把 我 们 想 要 传递 的 数据 暂 存在 Intent 中 ， 在 启动 另 一 个 Activity 后 ， 只 需要 把 这 些 数 据 从 
Intent 中 取出 就 可 以 了 。 比 如 说 FirstActivity 中 有 一 个 字符 串 ， 现 在 想 把 这 个 字符 串 传 递 到 
SecondActivity 中 ， 你 就 可 以 这 样 编写 : 


buttonl.setOnClickListener { 
val data = "Hello SecondActivity" 
val intent = Intent(this, SecondActivity::class.java) 
intent.putExtra("extra data", data) 
startActivity(intent) 

} 


这 里 我 们 还 是 使 用 显 式 Intent 的 方式 来 启动 SecondActivity， 并 通过 putExtra() 方 法 传递 了 
一 个 字符 串 。 注 意 ， 这 里 putExtra() 方 法 接收 两 个 参数 ， 第 一 个 参数 是 键 ， 用 于 之 后 从 
Intent 中 取 值 ， 第 二 个 参数 才 是 真正 要 传递 的 数据 。 


然后 在 SecondActivity 中 将 传递 的 数据 取出 ， 并 打印 出 来 ， 代 码 如 下 所 示 : 


class SecondActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.second layout) 
val extraData = intent.getStringExtra("extra data") 
Log.d("SecondActivity", "extra data is $extraData") 


} 


上 述 代码 中 的 jntent 实 际 上 调用 的 是 父 类 的 getIntent( ) 方 法 ,该 方法 会 获取 用 于 启动 
SecondActivity 的 Intent， 然后 调用 getStringExtra( ) 方 法 并 传 入 相应 的 键 值 ， 就 可 以 得 
到 传递 的 数据 了 。 这 里 由 于 我 们 传递 的 是 字符 串 ， 所 以 使 用 getStringExt ra() 方 法 来 获取 传 
递 的 数据 。 如 果 传 递 的 是 整 型 数据 ， 则 使 用 getIntExtra( ) 方 法 ; 如 果 传 递 的 是 布尔 型 数据 ， 
则 使 用 getBooLeanExtra( ) 方 法 ， 以 此 类 推 。 


重新 运行 程序 ,在 FirstActivity 的 界面 点 击 一 下 按钮 会 跳 转 到 SecondActivity， 查 看 Logcat 打 
印信 息 ， 如 图 3.21 所 示 。 


com.example.activitytest (10785) 下 Verbose “ 习 


785/com.example.activitytest D/SecondActivity: extra data is Hello SecondActivity 
图 3.21 SecondActivity 中 的 打印 信息 
可 以 看 到 ， 我 们 在 SecondActivity 中 成 功 得 到 了 从 FirstActivity 传 递 过 来 的 数据 。 
3.3.5 返回 数据 给 上 一 个 Activity 
既然 可 以 传递 数据 给 下 一 个 Activity， 那 么 能 不 能 够 返回 数据 给 上 一 个 Activity 呢 ? 答案 是 肯定 


的 。 不 过 不 同 的 是 ， 返回 上 一 个 Activity 只 需要 按 一 下 Back 键 就 可 以 了 ， 并 没有 一 个 用 于 启动 
Activity 的 Intent 来 传递 数据 ， 这 该 怎么 办 呢 ? 其 实 Activity 类 中 还 有 一 个 用 于 启动 Activity 的 
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startActivityForResutt () ) 方 法 ， 但 它 期 望 在 Activity 销 毁 的 时 候 能 够 返回 一 个 结果 给 上 
一 个 Activity。 毫 无 疑问 ,这 就 是 我 们 所 需要 的 。 


startActivityForResult() 方 法 接收 两 个 参数 : 第 一 个 参数 还 是 Intent ; 第 二 个 参数 是 请 
求 码 , 用 于 在 之 后 的 回调 中 判断 数据 的 来 源 。 我 们 还 是 来 实战 一 下 ， 修 改 FirstActivity 中 按钮 的 
点 击 事件 ， 代 码 如 下 所 示 : 


buttonl.setOnClickListener { 
val intent = Intent(this, SecondActivity::class.java) 
startActivityForResult(intent, 1) 


这 里 我 们 使 用 了 startActivityForResult() 方 法 来 启动 SecondActivity， 请求 码 只 
个 唯一 值 即 可 ， 这 里 传 入 了 1。 接 下 来 我 们 在 SecondActivity 中 人 按钮 注册 点 生 事 件 ， 
击 事件 中 添加 返回 数据 的 逻辑 ， 代 码 如 下 所 示 : 


class SecondActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 

super.onCreate(savedInstanceState) 
setContentView(R.layout.second layout) 
button2.setOnClickListener { 

val intent = Intent() 

intent.putExtra("data return", "Hello FirstActivity") 

setResult (RESULT OK, intent) 

finish() 


} 


可 以 看 到 ， 我 们 还 是 构建 了 一 个 Intent ,只 不 过 这 个 Intent 仅 仅 用 于 传递 数据 而 已 ， 二 
任何 的 “意图 "。 紧 接着 把 要 传递 的 数据 存放 在 Intent 中 ， 然 后 调用 了 setResutLt ( ) 方 法 。 

方法 非常 重要 ， 专 门 用 于 向 上 一 个 Activity 返 回 数据 。setResuLt ( ) 方 法 接收 两 个 参数 : 第 一 
个 参数 用 于 向 上 一 个 Activity 返 回 处 理 结果 ,一般 只 使 用 RESULT_0K 或 RESULT_CANCELED 这 

两 个 值 ; 第 二 个 参数 则 把 带 有 数据 的 Intent 传 递 回去 。 最 后 调用 了 finish( ) 方 法 来 销毁 当前 

Activity 。 


由 于 我 们 是 使 用 startActivityForResult() 方 法 来 启动 SecondActivity 的 ,在 
SecondActivity 被 销毁 之 后 会 回调 上 一 个 Activity 的 onActivityResult() 方 法 ,因此 我 们 
需要 在 FirstActivity 中 重 写 这 个 方法 来 得 到 返回 的 数据 ， 如 下 所 示 : 


override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { 
super.onActivityResult(requestCode, resultCode, data) 
when (requestCode) { 
1 -> if (resultCode == RESULT OK) { 
val returnedData = data?.getStringExtra("data return") 
Log.d("FirstActivity", "returned data is $returnedData") 
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onActivityResult() 方 法 带 有 3 个 参数 : 第 一 个 参数 requestCode , 即 我 们 在 启动 Activity 
时 传 入 的 请 求 码 ; 第 二 个 参数 resuLtCode， 即 我 们 在 返回 数据 时 传 入 的 处 理 结果 ; 第 三 个 参 
数 data，, 即 携带 着 返回 数据 的 Intent。 由 于 在 一 个 Activity 中 有 可 能 调用 
startActivityForResult() 方 法 去 启动 很 多 不 同 的 Activity , 每 一 个 Activity 返 回 的 数据 都 
会 回调 到 onActivityResult() 这 个 方法 中 ， 因 此 我 们 首先 要 做 的 就 是 通过 检查 
requestCode 的 值 来 判断 数据 来 源 。 确 定数 据 是 从 SecondActivity 返 回 的 之 后 ， 我 们 再 通过 
resultCode 的 值 来 判断 处 理 结果 是 否 成 功 。 最 后 从 data 中 取 值 并 打印 出 来 ， 这 样 就 完成 了 向 
上 一 个 Activity 返 回 数据 的 工作 。 


重新 运行 程序 , 在 FirstActivity 的 界面 点 击 按钮 会 打开 SecondActivity ,然后 在 
SecondActivity 界 面 点 击 Button 2 按钮 会 回 到 FirstActivity , 这 时 查看 Logcat 的 打印 信息 ， 如 
图 3.22 所 示 。 


com.example.activitytest (10787) Verbose “ Qr 


787/com.example.activitytest D/FirstActivity: returned data is Hello FirstActivity 
图 3.22 FirstActivity 中 的 打印 信息 

可 以 看 到 ,SecondActivity 已 经 成 功 返 回 数据 给 FirstActivity 了 。 

你 可 能 会 问 ， 如 果 用 户 在 SecondActivity 中 并 不 是 通过 点 击 按钮 ， 而 是 通过 按 下 Back 键 回 到 


FirstActivity， 这样 数 据 不 就 没 法 返回 了 吗 ? 没 错 ， 不 过 这 种 情况 还 是 很 好 处 理 的 ， 我 们 可 以 通 
过 在 SecondActivity 中 重 写 onBackPressed ( ) 方 法 来 解决 这 个 问题 ， 代 码 如 下 所 示 : 


override fun onBackPressed() { 
val intent = Intent() 
intent.putExtra("data return", "Hello FirstActivity") 
setResult (RESULT OK, intent) 
finish() 
} 


这 样 ， 当 用 户 按 下 Back 键 后 ， 就 会 执行 onBackPressed() 方 法 中 的 代码 ,我 们 在 这 里 添加 返 
回 数据 的 逻辑 就 行 了 。 
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3.4 _ Activity 的 生命 周期 

掌握 Activity 的 生命 周期 对 任何 Android 开 发 者 来 说 都 非常 重要 ， 当 你 深入 理解 Activity 的 生命 
周期 之 后 ， 就 可 以 写 出 更 加 连贯 流畅 的 程序 ,并 在 如 何 合理 管理 应 用 资源 方面 发 挥 得 游 刀 有 
余 。 你 的 应 用 程序 也 将 会 拥有 更 好 的 用 户 体验 。 


3.4.1 返回 栈 


经 过 前 面 几 节 的 学 习 ,相信 你 已 经 发 现 了 Android 中 的 Activity 是 可 以 层 到 的 。 我 们 每 启动 一 个 
新 的 Activity， 就 会 覆盖 在 原 Activity 之 上 ， 然 后 点 击 Back 键 会 销毁 最 上 面 的 Activity, 下面 的 
一 个 Activity 就 会 重新 显示 出 来 。 


其 实 Android 是 使 用 任务 (task) 来 管理 Activity 的 ， 一 个 任务 就 是 一 组 存放 在 栈 里 的 Activity 
的 集合 ， 这 个 栈 也 被 称 作 返 回 栈 (back stack) 。 配 是 一 种 后 进 先 出 的 数据 结构 ， 在 默认 情况 
下 ,每 当 我 们 启动 了 一 个 新 的 Activity， 它 就 会 在 返回 栈 中 入 栈 ， 并 处 于 栈 顶 的 位 置 。 而 每 当 我 
们 按 下 Back 键 或 调用 finish ( ) 方 法 去 销毁 一 个 Activity 时 ， 处 于 栈 顶 的 Activity 就 会 出 栈 ， 前 
一 个 入 栈 的 Activity 就 会 重新 处 于 栈 顶 的 位 置 。 系 统 总 是 会 显示 处 于 栈 顶 的 Activity 给 用 户 。 


示意 图 3.23 展 示 了 返回 栈 是 如 何 管理 Activity 入 栈 出 栈 操作 的 。 


启动 一 个 新 Activity 
将 栈 顶 Activity 移 除 


启动 的 Activity 


启动 的 Activity 


返回 栈 


图 3.23 返回 栈 工 作 示 意图 

3.4.2 Activity 状 态 

每 个 Activity 在 其 生命 周期 中 最 多 可 能 会 有 4 种 状态 。 
01. 运行 状态 


当 一 个 Activity 位 于 返回 枝 的 栈 顶 时 ，Activity 就 处 于 运行 状态 。 系 统 最 不 愿意 回收 的 就 是 
处 于 运行 状态 的 Activity， 因 为 这 会 带 来 非常 差 的 用 户 体验 。 
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02. 


03. 


04. 


暂停 状态 


当 一 个 Activity 不 再 处 于 栈 顶 位 置 ， 但 仍然 可 见 时 ，Activity 就 进入 了 暂停 状态 。 你 可 能 会 
觉得 ,既然 Activity 已 经 不 在 栈 顶 了 ， 怎么 会 可 见 呢 ? 这 是 因为 并 不 是 每 一 个 Activity 都 会 
占 满 整个 屏幕 ， 比 如 对 话 框 形式 的 Activity 只 会 占用 屏幕 中 间 的 部 分 区 域 。 处 于 暂停 状态 的 
Activity 仍 然 是 完全 存活 着 的 ， 系 统 也 不 愿意 回收 这 种 Activity (因为 它 还 是 可 见 的 ， 回收 
可 见 的 东西 都 会 在 用 户 体验 方面 有 不 好 的 影响 ) ， 只 有 在 内 存 极 低 的 情况 下 ， 系 统 才 会 去 
考虑 回收 这 种 Activity。 


停止 状态 

当 一 个 Activity 不 再 处 于 栈 顶 位 置 ， 并 且 完 全 不 可 见 的 时 候 ， 就 进入 了 停止 状态 。 系 统 仍然 
会 为 这 种 Activity 保 存 相应 的 状态 和 成 员 变量 ， 但 是 这 并 不 是 完全 可 靠 的 ， 当 其 他 地 方 需要 
内 存 时 ， 处 于 停止 状态 的 Activity 有 可 能 会 被 系统 回收 。 

销毁 状态 


一 个 Activity 从 返回 栈 中 移 除 后 就 变 成 了 销毁 状态 。 系 统 最 倾向 于 回收 处 于 这 种 状态 的 
Activity， 以 保证 手机 的 内 存 充足 。 


3.4.3 ”Activity 的 生存 期 


Activity 类 中 定义 了 7 个 回调 方法 ， 覆盖 了 Activity 生 命 周 期 的 每 一 个 环节 ， 下面 就 来 一 一 介绍 
这 7 个 方法 。 


onCreate () 。 这 个 方法 你 已 经 看 到 过 很 多 次 了 ， 我们 在 每 个 Activity 中 都 重 写 了 这 个 方 
法 ， 它 会 在 Activity 第 一 次 被 创建 的 时 候 调 用 。 你 应 该 在 这 个 方法 中 完成 Activity 的 初始 化 
操作 ， 比 如 加 载 布 局 、 绑 定 事件 等 。 

onStart ( )。 这 个 方法 在 Activity 由 不 可 见 变 为 可 见 的 时 候 调 用 。 

onResume ( ) 。 这 个 方法 在 Activity 准 备 好 和 用 户 进行 交互 的 时 候 调 用 。 此 时 的 Activity 一 
定位 于 返回 栈 的 栈 项 ， 并且 处 于 运行 状态 。 

onPause( )。 这 个 方法 在 系统 准备 去 启动 或 者 恢复 另 一 个 Activity 的 时 候 调 用 。 我 们 通常 
会 在 这 个 方法 中 将 一 些 消耗 CPU 的 资源 释放 掉 ， 以 及 保存 一 些 关键 数据 ,但 这 个 方法 的 执 
行 速度 一 定 要 快 ， 不 然 会 影响 到 新 的 栈 顶 Activity 的 使 用 。 

onStop () 。 这 个 方法 在 Activity 完 全 不 可 见 的 时 候 调 用 。 它 和 onPause ( ) 方 法 的 主要 区 
别 在 于 ， 如 果 启 动 的 新 Activity 是 一 个 对 话 框 式 的 Activity ,那么 onPause ( ) 方 法 会 得 到 执 
行 ， 而 onStop ( ) 方 法 并 不 会 执行 。 

onDestroy ()。 这 个 方法 在 Activity 被 销毁 之 前 调用 ,之 后 Activity 的 状态 将 变 为 销毁 状 
太 


/LUANo 
onRestart ( ) 。 这 个 方法 在 Activity 由 停止 状态 变 为 运行 状态 之 前 调用 ， 也 就 是 Activity 
被 重新 启动 了 。 


以 上 7 个 方法 中 除了 onRestart ( ) 方 法 ,其 他 都 是 两 两 相对 的 ， 从 而 又 可 以 将 Activity 分 为 以 
下 3 种 生存 期 。 
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。 完整 生存 期 。Activity 在 onCreate( ) 方 法 和 onDestroy () 方 法 之 间 所 经 历 的 就 是 完整 生 

存 期 。 一 般 情 况 下 ， 一 个 Activity 会 在 onCreate ( ) 方 法 中 完成 各 种 初始 化 操作 ， 而 在 

onDestroy() 方 法 中 完成 释放 内 存 的 操作 。 

可 见 生存 期 。Activity 在 onStart() 方 法 和 onStop() 方 法 之 间 所 经 历 的 就 是 可 见 生 存 

期 。 在 可 见 生 存 期 内 ，Activity 对 于 用 户 总 是 可 见 的 ， 即 便 有 可 能 无 法 和 用 户 进 行 交 互 。 我 

们 可 以 通过 这 两 个 方法 合理 地 管理 那些 对 用 户 可 见 的 资源 。 比 如 在 onStart ( ) 方 法 中 对 资 

源 进行 加 载 ， 而 在 onStop ( ) 方 法 中 对 资源 进行 释放 ， 从 而 保证 处 于 停止 状态 的 Activity 不 

会 占用 过 多 内 存 。 

。 前 台 生 存 期 。Activity 在 onResume ( ) 方 法 和 onPause ( ) 方 法 之 间 所 经 历 的 就 是 前 台 生存 
期 。 在 前 台 生 存 期 内 ，Activity 总 是 处 于 运行 状态 ， 此 时 的 Activity 是 可 以 和 用 户 进行 交互 
的 ， 我 们 平时 看 到 和 接触 最 多 的 就 是 这 个 状态 下 的 Activity。 


为 了 帮助 你 更 好 地 理解 ，Android 官 方 提供 了 一 张 Activity 生 命 周期 的 示意 图 ， 如 图 3.24 所 示 。 


启动 Activity 
> 
onCreate() 
vv 
onStart() < onRestart() 
vv 
返回 上 一 个 Activity onResume() < 一 一 一 一 ~、 
| + 
( 半 掉 进程 | Activity 运 行 中 


另 一 个 Activity 来 到 前 台 
返回 上 一 个 Activity 

vv 

另 一 八 优 第 绿 Er 

另 一 个 优先 级 更 高 - onPause() “一 一 一 


的 程序 需要 内 存 


Activity 不 再 可 见 

返回 上 一 个 Activity 
v 
onStop() 0 


Activity 被 销 和 


vv 
onDestroy() 


v 


(关闭 Activity “| 


图 3.24 Activity 的 生命 周期 
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3.4.4 体验 Activity 的 生命 周期 


讲 了 这 么 多 理论 知识 ， 是 时 候 进 行 实战 了 。 下 面 我 们 将 通过 一 个 实例 ， 让 你 可 以 更 加 直观 地 体 
验 Activity 的 生命 周期 。 


这 次 我 们 不 准备 在 ActivityTest 这 个 项 目的 基础 上 修改 了 ， 而 是 新 建 一 个 项 目 。 因 此 ， 首 先 关闭 
ActivityTest 项 目 , 点击 导 航 栏 File>Close Project。 然 后 新 建 一 个 ActivityLifeCycleTest 项 
目 ， 新建 项 目的 过 程 你 应 该 已 经 非常 清楚 了， 不 需要 我 再 进行 柳 述 ， 这 次 我 们 允许 Android 
Studio 帮 我 们 自动 创建 Activity 和 布局 , 这 样 可 以 省 去 不 少 工 作 ， 创建 的 Activity 名 和 布局 名 都 
使 用 默认 值 。 


这 样 主 Activity 就 创建 完成 了 ， 我 们 还 需要 分 别 再 创建 两 个 子 Activity 一 一 NormalActivity 和 
DialogActivity ,下面 一 步 步 来 实现 。 


右 击 com.example.activitylifecycletest 包 New 一 Activity>Empty Activity， 新建 
NormalActivity , 布局 起 名 为 normal_layout。 然 后 使 用 同样 的 方式 创建 DialogActivity , 布 
局 起 名 为 dialog_layout。 


现在 编辑 normal_layout.xmI 文 件 , 将 里 面 的 代码 替换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="This is a normal activity" 
/> 


</LinearLayout> 


在 这 个 布局 中 ， 我们 非常 简单 地 使 用 了 一 个 TextView， 用 于 显示 一 行文 字 ， 在 下 一 章 中 你 将 会 
学 到 关于 TextView 的 更 多 用 法 。 


然后 编辑 dialog_layout.xml 文 件 ， 将 里 面 的 代码 替换 成 如 下 内 容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="This is a dialog activity" 
/> 


</LinearLayout> 


两 个 布局 文件 的 代码 几乎 没有 区 别 ， 只 是 显示 的 文字 不 同 而 已 。 
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NormalActivity 和 DialogActivity 中 的 代码 我 们 保持 默认 就 好 ， 不 需要 改动 。 


其 实 从 名 字 上 就 可 以 看 出 ， 这 两 个 Activity 一 个 是 普通 的 Activity ,一 个 是 对 话 框 式 的 
Activity。 可 是 我 们 并 没有 修改 Activity 的 任何 代码 ， 两 个 Activity 的 代码 应 该 几乎 是 一 模 一 样 
的 ,那么 是 在 哪里 将 Activity 设 成 对 话 框 式 的 呢 ? 别 着 急 ， 下 面 我 们 马上 开始 设置 。 修 改 
AndroidManifest.xml 的 <activity> 标 签 的 配置 ,如 下 所 示 : 


<activity android:name=" .DialogActivity" 
android:theme="QstyLe/Theme .AppCompat .Dialog"> 


</activity> 
<activity android:name=".NormalActivity"> 
</activity> 


这 里 是 两 个 Activity 的 注册 代码 ,但 是 DialogActivity 的 代码 有 些 不 同 ， 我 们 给 它 使 用 了 一 个 
android:theme 属 性 ,用 于 给 当前 Activity 指 定 主题 ,Android 系统 内 置 有 很 多 主题 可 以 选 
择 ， 当 然 我 们 也 可 以 定制 自己 的 主题 ， 而 这 里 的 QstyLe/Theme .AppCompat .Dialog 则 毫 无 
疑问 是 让 DialogActivity 使 用 对 话 框 式 的 主题 。 


接 下 来 我 们 修改 activity_main.xml , 重新 定制 主 Activity 的 布局 ,将 里 面 的 代码 替换 成 如 下 内 
容 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/startNormalActivity" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Start NormalActivity" /> 


<Button 
android:id="@+id/startDialogActivity" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Start DialogActivity" /> 


</LinearLayout> 


可 以 看 到 ,我们 在 LinearLayout 中 加 入 了 两 个 按钮 ， 一 个 用 于 局 动 NormalActivity ,一 个 用 于 
启动 DialogActivity。 


最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val tag = "MainActivity" 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d(tag, "onCreate") 
setContentView(R.layout.activity main) 
startNormalActivity.setOnClickListener { 
val intent = Intent(this, NormalActivity::class.java) 
startActivity(intent) 
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startDialogActivity.setOnClickListener { 
val intent = Intent(this, DialogActivity::class.java) 
startActivity(intent) 


} 


override fun onStart() { 
super.onStart() 
Log.d(tag, "onStart") 
} 


override fun onResume() { 
super.onResume() 
Log.d(tag, "onResume") 


} 


override fun onPause() { 
super.onPause() 
Log.d(tag, "onPause") 
} 


override fun onStop() { 
super.onStop() 
Log.d(tag, "onStop") 
} 


override fun onDestroy() { 
super.onDestroy() 
Log.d(tag, "onDestroy") 
} 


override fun onRestart() { 
super.onRestart() 
Log.d(tag, "onRestart") 


} 


在 onCreate ( ) 方 法 中 ， 我 们 分 别 为 两 个 按钮 注册 了 点 击 事件 ， 点 击 第 一 个 按钮 会 启动 
NormalActivity , 点击 第 二 个 按钮 会 启动 DialogActivity。 然 后 在 Activity 的 7 个 回调 方法 中 分 
别 打印 了 一 名 话 ， 这 样 就 可 以 通过 观察 日 志 来 更 直观 地 理解 Activity 的 生命 周期 。 


现在 运行 程序 ,效果 如 图 3.25 所 示 。 
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10:08 


ActivityLifeCycleTest 


START NORMALACTIVITY 


START DIALOGACTIVITY 


图 3.25 MainActivity 界 面 


这 时 观察 Logcat 中 的 打印 日 志 ,如 图 3.26 所 示 。 


com.example.activitylifecycletes! Verbose | Qr 


258/com.example.activitylifecycletest D/MainActivity: onCreate 
258/com.example.activitylifecycletest D/MainActivity: onStart 
258/com.example.activitylifecycletest D/MainActivity: onResume 


图 3.26 ”启动 程序 时 的 打印 日 志 


可 以 看 到 ， 当 MainActivity 第 一 次 被 创建 时 会 依次 执行 onCreate()、onStart() 和 
onResume ( ) 方 法 。 然 后 点 击 第 一 个 按钮 ,启动 NormalActivity , 如 图 3.27 所 示 。 
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10:09 


ActivityLifeCycleTest 


This is a normal activity 


图 3.27 ”NormalActivity 界 面 


此 时 的 打印 信息 如 图 3.28 所 示 。 


com.example.activitylifecycletesi Verbose | Qr 


258/com.example.activitylifecycletest D/MainActivity: onPause 
258/com.example.activitylifecycletest D/MainActivity: onStop 


图 3.28 打开 NormalActivity 时 的 打印 日 志 


由 于 NormalActivity 已 经 把 MainActivity 完 全 遮挡 住 ， 因 此 onPause( ) 和 onStop ( ) 方 法 都 会 
得 到 执行 。 然 后 按 下 Back 键 返回 MainActivity ,打印 信息 如 图 3.29 所 示 。 
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com.example.activitylifecycletesl Verbose | Qr 


258/com.example.activitylifecycletest D/MainActivity: onRestart 
258/com.example.activitylifecycletest D/MainActivity: onStart 
258/com.example.activitylifecycletest D/MainActivity: onResume 


图 3.29 返回 MainActivity 时 的 打印 日 志 


由 于 之 前 MainActivity 已 经 进入 了 停止 状态 ,所 以 onRestart ( ) 方 法 会 得 到 执行 ， 之 后 会 依次 
执行 onStart() 和 onResume () 方 法 。 注 意 ,此 时 onCreate ( ) 方 法 不 会 执行 ， 因 为 
MainActivity 并 没有 重新 创建 。 


然后 点 击 第 二 个 按钮 ， 启 动 DialogActivity， 如 图 3.30 所 示 。 


ActivityLifeCycleTest 


图 3.30 DialogActivity 界 面 
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此 时 观察 打印 信息 ， 如 图 3.31 所 示 。 


com.example.activitylifecycletesl Verbose 了 


258/com.example.activitylifecycletest D/MainActivity: onPause 


图 3.31 打开 DialogActivity 时 的 打印 日 志 


可 以 看 到 ,只 有 onPause( ) 方 法 得 到 了 执行 ,onStop () 方 法 并 没有 执行 ,这 是 因为 
DialogActivity 并 没有 完全 谈 力 朱 住 MainActivity ， 此 时 MainActivity 只 是 进入 了 暂停 状态 ， 并 
没有 进入 停止 状态 。 相 应 地 , 按 下 Back 键 返回 MainActivity 也 应 该 只 有 onResume ( ) 方 法 会 得 
到 执行 ， 如 图 3.32 所 示 。 


com.example.activitylifecycletesl Verbose “地 Qr 


258/com.example.activitylifecycletest D/MainActivity: onResume 


图 3.32 再 次 返回 MainActivity 时 的 打印 日 志 
最 后 在 MainActivity 按 下 Back 键 退出 程序 ， 打 印信 息 如 图 3.33 所 示 。 


com.example.activitylifecycletesl 地 Verbose Q- 


258/com.example.activitylifecycletest D/MainActivity: onPause 
258/com.example.activitylifecycletest D/MainActivity: onStop 
258/com.example.activitylifecycletest D/MainActivity: onDestroy 


图 3.33 ”退出 程序 时 的 打印 日 志 
依次 会 执行 onPause()、onStop() 和 onDest roy () 方 法 ,最终 销 毁 MainActivity。 
这 样 Activity 完 整 的 生命 周期 你 已 经 体验 了 一 遍 ， 是 不 是 理解 得 更 加 深刻 了 ? 


3.4.5 Activity 被 回收 了 怎么 办 


前 面 我 们 说 过 ， 当 一 个 Activity 进 入 了 停止 状态 ， 是 有 可 能 被 系统 回收 的 。 那 么 想象 以 下 场景 : 
应 用 中 有 一 个 Activity A， 用 户 在 Activity A 的 基础 上 启动 了 Activity B ,Activity A 就 进入 了 
停止 状态 ， 这 个 时 候 由 于 系统 内 存 不 足 ， 将 Activity A 回收 掉 了 ， 然 后 用 户 按 下 Back 键 返回 
Activity 人， 会 出 现 什么 Be ? 其 实 还 是 会 正常 显示 Activity A 的 ， 只 不 过 这 时 并 不 会 执行 
onRestart () 方 法 ,而 是 会 执行 Activity A 的 onCreate( ) 方 法 ， 因 为 Activity A 在 这 种 情况 
下 会 被 重新 创建 一 次 。 


这 样 看 上 去 好 像 一 切 正常 ， 可 是 别 忽略 了 一 个 重要 问题 : Activity A 中 是 可 能 存在 临时 数据 和 状 
态 的 。 打 个 比方 ，MainActivity 中 如 果 有 一 个 文本 输入 框 ， 现 在 你 输入 了 一 段 文 字 ， 然 后 启动 
NormalActivity , 这 时 MainActivity 由 于 系统 内 存 不 足 被 回收 掉 ,过 了 一 会 你 又 点 击 了 Back 键 
回 到 MainActivity， 你 会 发 现 刚 刚 输入 的 文字 都 没 了 ， 因 为 MainActivity 被 重新 创建 了 。 
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如 果 我 们 的 应 用 出 现 了 这 种 情况 ， 是 会 比较 影响 用 户 体验 的 ， 所 以 得 想 想 办 法 解决 这 个 问题 。 
其 实 , Activity 中 还 提供 了 一 个 onSaveInstanceState() 回 调 方法 , 这 个 方法 可 以 保证 在 
Activity 被 回收 之 前 一 定 会 被 调用 ， 因 此 我 们 可 以 通过 这 个 方法 来 解决 问题 。 


onSaveInstanceState( ) 方 法 会 携带 一 个 Bundle 类 型 的 参数 ，Bundle 提 供 了 一 系列 的 方法 
用 于 保存 数据 ， 比 如 可 以 使 用 putString() 方 法 保存 字符 串 ， 使 用 putInt( ) 方 法 保存 整 型 数 
据 ,以 此 类 推 。 每 个 保存 方法 需要 传 入 两 个 参数 ， 第 一 个 参数 是 键 ， 用 于 后 面 从 BundLe 中 取 
值 ， 第 二 个 参数 是 真正 要 保存 的 内 容 。 


在 MainActivity 中 添加 如 下 代码 就 可 以 将 临时 数据 进行 保存 了 : 


override fun onSaveInstanceState(outState: Bundle) { 
super.onSaveInstanceState(outState) 
val tempData = "Something you just typed" 
outState.putString("data key", tempData) 

} 


数据 是 已 经 保存 下 来 了 ， 那么 我 们 应 该 在 哪里 进行 恢复 呢 ? 细心 的 你 也 许 早 就 发 现 ， 我们 一 直 
使 用 的 onCreate ( ) 方 法 其 实 也 有 一 个 BundLe 类 型 的 参数 。 这 个 参数 在 一 般 情况 下 都 是 
null , 但 是 如 果 在 Activity 被 系统 回收 之 前 ， 你 通过 onSaveInstanceState () 方 法 保存 数 
据 ,这 个 参数 就 会 带 有 之 前 保存 的 全 部 数据 ,我 们 只 需要 再 通过 相应 的 取 值 方法 将 数据 取出 即 
可 。 


修改 MainActivity 的 onCreate ( ) 方 法 ， 如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d(tag, "onCreate") 
setContentView(R.layout.activity main) 
if (savedInstanceState != null) { 
val tempData = savedInstanceState.getString("data key") 
Log.d(tag, "tempData is $tempData") 


} 


取出 值 之 后 再 做 相应 的 恢复 操作 就 可 以 了 ， 比 如 将 文本 内 容重 新 赋值 到 文本 输入 框 上 ,这 里 我 
们 只 是 简单 地 打印 一 下 。 


不 知道 你 有 没有 察觉 ,使 用 BundLe 保 存 和 取出 数据 是 不 是 有 些 似曾相识 呢 ? 没 错 ! 我 们 在 使 用 
Intent 传 递 数 据 时 也 用 的 类 似 的 方法 。 这 里 提醒 一 点 ,Intent 还 可 以 结合 BundtLe 一 起 用 于 传递 
数据 。 首 先 我 们 可 以 把 需要 传递 的 数据 都 保存 在 BundLe 对 象 中 ， 然 后 再 将 BundLe 对 象 存 放 在 
Intent 里 。 到 了 目标 Activity 之 后 ， 先 从 Intent 中 取出 BundLe， 再 从 BundtLe 中 一 一 取出 数据 。 
具体 的 代码 我 就 不 写 了 ， 要 学 会 举一反三 哦 。 


另外 ， 当 手机 的 屏幕 发 生 旋转 的 时 候 ，Activity 也 会 经 历 一 个 重新 创建 的 过 程 ， 因 而 在 这 种 情况 
下 ， Activity 中 的 数据 也 会 丢失 。 虽 然 这 个 问题 同样 可 以 通过 onSaveInstanceState( ) 方 法 
来 解决 ， 但 是 一 般 不 太 建 议 这 么 做 ， 因 为 对 于 横竖 屏 旋转 的 情况 ， 现 在 有 更 加 优雅 的 解决 方 

案 ,我 们 将 13.2 节 中 学 习 。 
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3.5 _ Activity 的 启动 模式 


Activity 的 局 动 模 式 对 你 来 说 应 该 是 个 全 新 的 概念 ， 在 实际 项 目 中 我 们 应 该 根据 特定 的 需求 为 每 
个 Activity 指 定 恰当 的 启动 模式 。 启 动 模式 一 共有 4 种 ， 分别 是 standard、singleTop、 
singleTask 和 singlelnstance , 可 以 在 AndroidManifest.xml 中 通过 给 <activity> 标 签 指定 
android:LaunchMode 属 性 来 选择 启动 模式 。 下 面 我 们 来 逐个 进行 学 习 。 


3.5.1 _ standard 


standard 是 Activity 默 认 的 启动 模式 ， 在 不 进行 显 式 指定 的 情况 下 ， 所 有 Activity 都 会 自动 使 用 
这 种 启动 模式 。 到 目前 为 止 ， 我 们 写 过 的 所 有 Activity 都 是 使 用 的 standard 模 式 。 经 过 上 一 节 
的 学 习 ,你 已 经 知道 了 Android 是 使 用 返回 栈 来 管理 Activity 的 ， 在 standard 模 式 下 , 每 当局 
动 一 个 新 的 Activity， 它 就 会 在 返回 栈 中 入 栈 ， 并 处 于 栈 顶 的 位 置 。 对 于 使 用 standard 模 式 的 
Activity， 系 统 不 会 在 乎 这 个 Activity 是 否 已 经 在 返回 栈 中 存在 ,每 次 启动 都 会 创建 一 个 该 
Activity 的 新 实例 。 


我 们 现在 通过 实践 来 体会 一 下 standard 模 式 ， 这 次 还 是 在 ActivityTest 项 目的 基础 上 修改 。 首 
先 关闭 ActivityLifeCycleTest 项 目 ,打开 ActivityTest 项 目 。 


修改 FirstActivity 中 onCreate ( ) 方 法 的 代码 , 如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("FirstActivity", this.toString()) 
setContentView(R.layout.first layout) 
buttonl.setOnClickListener { 
val intent = Intent(this, FirstActivity::class.java) 
startActivity(intent) 
} 


} 


代码 看 起 来 有 些 奇怪 吧 ? 在 FirstActivity 的 基础 上 启动 FirstActivity。 从 逻辑 上 来 讲 ， 这 确实 没 
什么 意义 ， 不 过 我 们 的 重点 在 于 研究 standard 模 式 ， 因 此 不 必 在 意 这 段 代码 有 什么 实际 用 途 。 
另外 我 们 还 在 onCreate ( ) 方 法 中 添加 了 一 行 打印 信息 ， 用 于 打印 当前 Activity 的 实例 。 


现在 重新 运行 程序 ,然后 在 FirstActivity 界 面 连续 点 击 两 次 按钮 ， 可 以 看 到 Logcat 中 的 打印 信 
息 如 图 3.34 所 示 。 


Qr 


com.example.activitytest (25570) 地 Verbose 地 


5570/com.example.activitytest D/FirstActivity: com.example.activitytest,.FirstActivity@7438bfa 
5570/com.example.activitytest D/FirstActivity: com.example.activitytest.FirstActivity@c40b9ae 
5570/com.example.activitytest D/FirstActivity: com.example.activitytest,.FirstActivity@3376909 


图 3.34 standard 模 式 下 的 打印 日 志 


从 打印 信息 中 可 以 看 出 ， 每 点 击 一 次 按钮 ， 就 会 创建 出 一 个 新 的 FirstActivity 实 例 。 此 时 返回 栈 
中 也 会 存在 3 个 FirstActivity 的 实例 ,因此 你 需要 连 按 3 次 Back 键 才能 退出 程序 。 
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standard 模 式 的 原理 如 图 3.35 所 示 。 


FirstActivity 
启动 新 Activity 返回 
FirstActivity 
启动 新 Activity 返回 
FirstActivity 
返回 栈 


图 3.35 ”standard 模 式 原理 示意 图 
3.5.2 singleTop 


可 能 在 有 些 情况 下 ， 你 会 觉得 standard 模 式 不 太 合理 。Activity 明 明 已 经 在 栈 顶 了 ， 为 什么 再 
次 启动 的 时 候 还 要 创建 一 个 新 的 Activity 实 例 呢 ? 别 着 急 ， 这 只 是 系统 默认 的 一 种 启动 模式 而 
已 ， 你 完全 可 以 根据 自己 的 需要 进行 修改 ， 比 如 使 用 singleTop 模 式 。 当 Activity 的 启动 模式 指 
定 为 singleTop , 在 启动 Activity 时 如 果 发 现 返回 材 的 栈 顶 已 经 是 该 Activity， 则 认为 可 以 直接 
使 用 它 ， 不 会 再 创建 新 的 Activity 实 例 。 


我 们 还 是 通过 实践 来 体会 一 下 ,修改 AndroidManifest.xml 中 FirstActivity 的 局 动 模式 ， 如 下 
所 示 : 


<activity 
android:name=" .FirstActivity" 
android:launchMode="singleTop" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN"/> 
<category android:name="android.intent.category.LAUNCHER"/> 
</intent-filter> 
</activity> 


然后 重新 运行 程序 ， 查 看 Logcat ,你 会 看 到 已 经 创建 了 一 个 FirstActivity 的 实例 ,如 图 3.36 所 
示 。 


com.example.activitytest (26153) Verbose vv QO 


153/com.example.activitytest D/FirstActivity: com.example.activitytest.FirstActivity@7438bfa 
图 3.36 singleTop 模 式 下 的 打印 日 志 


但 是 之 后 不 管 你 点 击 多 少 次 按钮 都 不 会 再 有 新 的 打印 信息 出 现 ， 因 为 目前 FirstActivity 已 经 处 于 
返回 栈 的 栈 顶 ,每 当 想 要 再 启动 一 个 FirstActivity 时 ， 都 会 直接 使 用 栈 顶 的 Activity， 因 此 
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FirstActivity 只 会 有 一 个 实例 ， 仅 按 一 次 Back 键 就 可 以 退出 程序 。 
不 过 当 FirstActivity 并 未 处 于 栈 顶 位 置 时 ， 再 启动 FirstActivity 还 是 会 创建 新 的 实例 的 。 
下 面 我 们 来 实验 一 下 ， 修 改 FirstActivity 中 onCreate() 方 法 的 代码 ,如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("FirstActivity", this.toString()) 
setContentView(R.layout.first layout) 
buttonl.setOnClickListener { 
val intent = Intent(this, SecondActivity::class.java) 
startActivity(intent) 


} 


这 次 我 们 点 击 按钮 后 启动 的 是 SecondActivity。 然 后 修改 SecondActivity 中 onCreate( ) 方 法 
的 代码 ， 如 下 所 示 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("SecondActivity", this.toString()) 
setContentView(R. layout.second layout) 
button2.setOnClickListener { 
val intent = Intent(this, FirstActivity::class.java) 
startActivity(intent) 


} 


我 们 在 SecondActivity 中 添加 了 一 行 打印 日 志 , 并 且 在 按钮 点 击 事件 里 加 入 了 启动 
FirstActivity 的 代码 。 现 在 重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 进入 
SecondActivity， 然 后 在 SecondActivity 界 面 点 击 按钮 ， 又 会 重新 进入 FirstActivity 。 


查看 Logcat 中 的 打印 信息 ， 如 图 3.37 所 示 。 


com.example.activitytest (20283) 地 Verbose “地 Q 


1283/com.example.activitytest D/FirstActivity: com.example.activitytest.FirstActivity@2913896 
1283/com.example.activitytest D/SecondActivity: com.example.activitytest.SecondActivity@4b8b9f6 
1283/com.example.activitytest D/FirstActivity: com.example.activitytest.FirstActivity@361d8c4 


图 3.37 singleTop 模 式 下 的 打印 日 志 


可 以 看 到 系统 创建 了 两 个 不 同 的 FirstActivity 实 例 ， 这 是 由 于 在 SecondActivity 中 再 次 启动 
FirstActivity 时 ， 栈 顶 Activity 已 经 变 成 了 SecondActivity， 因 此 会 创建 一 个 新 的 FirstActivity 
实例 。 现 在 按 下 Back 键 会 返回 到 SecondActivity ,再 次 按 下 Back 键 又 会 回 到 FirstActivity ， 
再 按 一 次 Back 键 才 会 退出 程序 。 


singleTop 模 式 的 原理 如 图 3.38 所 示 。 
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FirstActivity 


检查 栈 顶 判断 返回 
是 否 需 要 启动 
新 Activit es 
新 Activity SecondActivity 
启动 新 Activity 返 下 
FirstActivity 
返回 栈 


图 3.38 singleTop 模 式 原理 示意 图 
3.5.3 singleTask 


使 用 singleTop 模 式 可 以 很 好 地 解决 重复 创建 栈 顶 Activity 的 问题 ， 但 是 正如 你 在 上 一 节 所 看 到 
的 ， 如 果 该 Activity 并 没有 处 于 栈 顶 的 位 置 ， 还 是 可 能 会 创建 多 个 Activity 实 例 的 。 那 么 有 没有 
什么 办 法 可 以 让 某 个 Activity 在 整个 应 用 程序 的 上 下 文中 只 存在 一 个 实例 呢 ? 这 就 要 借助 
singleTask 模 式 来 实现 了 。 当 Activity 的 启动 模式 指定 为 singleTask , 每 次 启动 该 Activity 时 ， 
系统 首先 会 在 返回 栈 中 检查 是 否 存在 该 Activity 的 实例 ， 如 果 发 现 已 经 存在 则 直接 使 用 该 实例 ， 
并 把 在 这 个 Activity 之 上 的 所 有 其 他 Activity 统 统 出 栈 ， 如 果 没 有 发 现 就 会 创建 一 个 新 的 
Activity 实 例 。 


我 们 还 是 通过 代码 来 更 加 直观 地 理解 一 下 。 修 改 AndroidManifest.xml 中 FirstActivity 的 启动 
模式 : 


<activity 
android:name=" .FirstActivity" 
android:launchMode="singleTask" 
android:label="This is FirstActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 


然后 在 FirstActivity 中 添加 onRestart() 方 法 ,并 打印 日 志 : 


override fun onRestart() { 
super.onRestart() 
Log.d("FirstActivity", "onRestart") 


} 


最 后 在 SecondActivity 中 添加 onDestroy() 方 法 ,并 打印 日 志 : 


override fun onDestroy() { 
super.onDestroy() 
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Log.d("SecondActivity", "onDestroy") 
} 


现在 重新 运行 程序 ， 在 FirstActivity 界 面 点 击 按钮 进入 SecondActivity， 然 后 在 
SecondActivity 界 面 点 击 按钮 ， 又 会 重新 进入 FirstActivity。 


查看 Logcat 中 的 打印 信息 ,如 图 3.39 所 示 。 


com.example.activitytest (23890) v Verbose 地 


890/com.example.activitytest D/FirstActivity: com.example.activitytest,.FirstActivity@7438bfa 
890/com.example.activitytest D/SecondActivity: com.example.activitytest,.SecondActivity@ab6434f 
890/com.example.activitytest D/FirstActivity: onRestart 

890/com.example.activitytest D/SecondActivity: onDestroy 


图 3.39 ”singleTask 模 式 下 的 打印 日 志 


其 实 从 打印 信息 中 就 可 以 明显 看 出 ， 在 SecondActivity 中 启动 FirstActivity 时 ， 会 发 现 返 回 栈 
中 已 经 存在 一 个 FirstActivity 的 实例 ， 并 且 是 在 SecondActivity 的 下 面 ， 于 是 SecondActivity 
会 从 返回 栈 中 出 栈 ,而 FirstActivity 重 新 成 为 了 栈 顶 Activity， 因 此 FirstActivity 的 
onRestart () 方 法 和 SecondActivity 的 onDestroy ( ) 方 法 会 得 到 执行 。 现 在 返回 栈 中 只 剩 下 
一 个 FirstActivity 的 实例 了 ， 按 一 下 Back 键 就 可 以 退出 程序 。 


singleTask 模 式 的 原理 如 图 3.40 所 示 。 


直接 出 栈 来 重新 启动 FirstActivity 


SecondActivity 


启动 SecondActivity 


FirstActivity 


返回 栈 
图 3.40 singleTask 模 式 原 理 示 意图 
3.5.4 singlelnstance 


singlelnstance 模 式 应 该 算是 4 种 启动 模式 中 最 特殊 也 最 复杂 的 一 个 了 ， 你 也 需要 多 花 点 工夫 来 
理解 这 个 模式 。 不 同 于 以 上 3 种 启动 模式 ， 指 定 为 singlelnstance 模 式 的 Activity 会 启用 一 个 新 
的 返回 栈 来 管理 这 个 Activity (其 实 如 果 singleTask 模 式 指定 了 不 同 的 taskAffinity , 也 会 启动 
一 个 新 的 返回 栈 ) 。 那 么 这 样 做 有 什么 意义 呢 ? 想象 以 下 场景 ,假设 我 们 的 程序 中 有 一 个 
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Activity 是 允许 其 他 程序 调用 的 ， 如 果 想 实现 其 他 程序 和 我 们 的 程序 可 以 共享 这 个 Activity 的 实 
例 , 应 该 如 何 实现 呢 ? 使 用 前 面 3 种 启动 模式 肯定 是 做 不 到 的 ， 因 为 每 个 应 用 程序 都 会 有 自己 的 
返回 栈 ,同一 个 Activity 在 不 同 的 返回 栈 中 入 栈 时 必然 创建 了 新 的 实例 。 而 使 用 
singlelnstance 模 式 就 可 以 解决 这 个 问题 ， 在 这 种 模式 下 ， 会 有 一 个 单独 的 返回 材 来 管理 这 个 
Activity， 不管 是 哪个 应 用 程序 来 访问 这 个 Activity， 都 共用 同一 个 返回 栈 ， 也 就 解决 了 共享 
Activity 实 例 的 问题 。 


为 了 帮助 你 更 好 地 理解 这 种 启动 模式 ， 我 们 还 是 来 实践 一 下 。 修 改 AndroidManifest.xml 中 
SecondActivity 的 局 动 模式 : 


<activity android:name=".SecondActivity" 
android:launchMode="singleInstance"> 
<intent-filter> 
<action android:name="com.example.activitytest.ACTION START" /> 
<category android:name="android.intent.category.DEFAULT" /> 
<category android:name="com.example.activitytest.MY CATEGORY" /> 
</intent-filter> 
</activity> 


我 们 先 将 SecondActivity 的 启动 模式 指定 为 singlelnstance ,然后 修改 FirstActivity 中 
onCreate( ) 方 法 的 代码 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("FirstActivity", "Task id is $taskId") 
setContentView(R.layout.first layout) 
buttonl.setOnClickListener { 
val intent = Intent(this, SecondActivity::class.java) 
startActivity(intent) 


} 


这 里 我 们 在 onCreate ( ) 方 法 中 打印 了 当前 返回 栈 的 1d。 注 意 上 述 代码 中 的 taskId 实 际 上 调用 
的 是 父 类 的 getTaskId () 方 法 。 然 后 修改 SecondActivity 中 onCreate ( ) 方 法 的 代码 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("SecondActivity", "Task id is $taskId") 
setContentView(R. layout.second layout) 
button2.setOnClickListener { 
val intent = Intent(this, ThirdActivity::class.]java) 
startActivity(intent) 


} 


同样 在 onCreate ( ) 方 法 中 打印 了 当前 返回 栈 的 1d， 然 后 又 修改 了 按钮 点 击 事件 的 代码 ， 用 于 
启动 ThirdActivity。 最 后 修改 ThirdActivity 中 onCreate( ) 方 法 的 代码 : 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("ThirdActivity", "Task id is $taskId") 
setContentView(R. layout.third layout) 


www.blogss.cn 


仍然 是 在 onCreate ( ) 方 法 中 打印 了 当前 返回 栈 的 id。 


现在 重新 运行 程序 , 在 FirstActivity 界 面 点 击 按钮 进入 SecondActivity， 然 后 在 
SecondActivity 界 面 点 击 按钮 进入 ThirdActivity 。 


查看 Logcat 中 的 打印 信息 ， 如 图 3.41 所 示 。 


com.example.activitytest (27345) 地 Verbose “= Qr 


345/com.example.activitytest D/FirstActivity: Task id is 37 
345/com.example.activitytest D/SecondActivity: Task id is 38 
345/com.example.activitytest D/ThirdActivity: Task id is 37 


图 3.41 singlelnstance 模 式 下 的 打印 日 志 


可 以 看 到 ,SecondActivity 的 Task id 不 同 于 FirstActivity 和 ThirdActivity， 这 说 明 
SecondActivity 确 实 是 存放 在 一 个 单独 的 返回 栈 里 的 ， 而 且 这 个 栈 中 只 有 SecondActivity 这 一 
个 Activity。 


然后 我 们 按 下 Back 键 进行 返回 ， 你 会 发 现 ThirdActivity 竟 然 直 接 返回 到 了 FirstActivity， 再 按 
下 Back 键 又 会 返回 到 SecondActivity ,再 按 下 Back 键 才 会 退出 程序 , 这 是 为 什么 呢 ? 其 实 原 
理 很 简单 ， 由 于 FirstActivity 和 ThirdActivity 是 存放 在 同一 个 返回 栈 里 的 ， 当 在 ThirdActivity 
的 界面 按 下 Back 键 时, ThirdActivity 会 从 返回 栈 中 出 栈 ， 那么 FirstActivity 就 成 为 了 栈 顶 
Activity 显 示 在 界面 上 ， 因 此 也 就 出 现 了 从 ThirdActivity 直 接 返回 到 FirstActivity 的 情况 。 然 后 
在 FirstActivity 界 面 再 次 按 下 Back 键 ， 这 时 当前 的 返回 栈 已 经 空 了 ， 于 是 就 显示 了 另 一 个 返回 
栈 的 栈 顶 Activity ， 即 SecondActivity。 最 后 再 次 按 下 Back 键 ， 这 时 所 有 返回 栈 都 已 经 空 了 ， 
也 就 自然 退出 了 程序 。 


singlelnstance 模 式 的 原理 如 图 3.42 所 示 。 


启动 新 Activity 
ThirdActivity 
返回 
启动 新 Activity 
FirstActivity SecondActivity 
返回 楼 A 派 返回 栈 B 


图 3.42 singlelnstance 模 式 原理 示意 图 
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3.6 Activity 的 最 佳 实践 


关于 Activity， 你 已 经 掌握 了 非常 多 的 知识 ， 不 过 恐怕 离 能 够 完全 灵活 运用 还 有 一 段 距离 。 虽 然 
知识 点 只 有 这 么 多 ， 但 运用 的 技巧 却 是 多 种 多 样 的 。 所 以 ， 在 这 里 我 准备 教 你 几 种 关于 Activity 
的 最 佳 实践 技巧 ， 这 些 技巧 在 你 以 后 的 开发 工作 当中 将 会 非常 有 用 。 


3.6.1 知晓 当前 是 在 哪 一 个 Activity 


这 个 技巧 将 教会 你 如 何 根据 程序 当前 的 界面 就 能 判断 出 这 是 哪 一 个 Activity。 可 能 你 会 觉得 挺 纳 
闷 的 ,我 自己 写 的 代码 怎么 会 不 知道 这 是 哪 一 个 Activity 呢 ? 然而 现实 情况 是 ， 在 你 进入 一 家 公 
司 之 后 ,更 有 可 能 的 是 接手 一 份 别人 写 的 代码 ， 因 为 你 刚 进 公 司 就 正好 有 一 个 新 项 目 局 动 的 概 
率 并 不 高 。 阅 读 别 人 的 代码 时 有 一 个 很 头疼 的 问题 ， 就 是 当 你 需要 在 某 个 界面 上 修改 一 些 非常 
简单 的 东西 时 ， 却 半天 找 不 到 这 个 界面 对 应 的 Activity 是 哪 一 个 。 学 会 了 本 节 的 技巧 之 后 ， 这 对 
你 来 说 就 再 也 不 是 难题 了 。 


我 们 还 是 在 ActivityTest 项 目的 基础 上 修改 ， 首先 需要 新 建 一 个 BaseActivity 类 。 右 击 
com.example.activitytest 包 New 王 Kotlin File/Class， 在 弹出 的 窗口 中 输入 
BaseActivity , 创建 类 型 选择 Class , 如 图 3.43 所 示 。 


© (3 New Kotlin File/Class 
Name: | BaseActivity 4 
Kind: 和 Class v 


图 3.43 创建 BaseActivity 类 


注意 ， 这 里 的 BaseActivity 和 普通 Activity 的 创建 方式 并 不 一 样 ， 因 为 我 们 不 需要 让 
BaseActivity 在 AndroidManifest.xml 中 注册 ， 所 以 选择 创建 一 个 普通 的 Kotlin 类 就 可 以 
了 。 然 后 让 BaseActivity 继 承 自 AppCompatActivity , 并 重 写 onCreate() 方 法 ,如 下 所 
示 : 
open class BaseActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("BaseActivity", javaClass.simpleName) 


} 
} 


我 们 在 onCreate() 方 法 中 加 了 一 行 日 志 , 用 于 打印 当前 实例 的 类 名 。 这 里 我 要 额外 说 明 一 
下 ，Kotlin 中 的 javaClass 表 示 获 取 当 前 实例 的 Class 对 象 ， 相 当 于 在 Java 中 调用 
getClass() 方 法 ; 而 Kotlin 中 的 BaseActivity::class.java 表 示 获 取 BaseActivity 类 的 
Class 对 象 ， 相 当 于 在 Java 中 调用 BaseActivity,.,class。 在 上 述 代码 中 ， 我们 先是 获取 了 当 
前 实例 的 Class 对 象 ， 然 后 再 调用 simpLeName 获 取 当 前 实例 的 类 名 。 
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接 下 来 我 们 需要 让 BaseActivity 成 为 ActivityTest 项 目 中 所 有 Activity 的 父 类 , 为 了 使 
BaseActivity 可 以 被 继承 ， 我 已 经 提前 在 类 名 的 前 面 加 上 了 open 关 键 字 。 然 后 修改 
FirstActivity、SecondActivity 和 ThirdActivity 的 继承 结构 ， 让 它们 不 再 继承 自 
AppCompatActivity , 而 是 继承 自 BaseActivity。 而 由 于 BaseActivity 又 是 继承 自 
AppCompatActivity 的 ， 所 以 项 目 中 所 有 Activity 的 现 有 功能 并 不 受 影响 ， 它们 仍然 继承 了 
Activity 中 的 所 有 特性 。 


现在 重新 运行 程序 ， 然后 通过 点 击 按钮 分 别 进入 FirstActivity、SecondActivity 和 
ThirdActivity 的 界面 ， 这 时 观察 Logcat 中 的 打印 信息 ， 如 图 3.44 所 示 。 


com.example.activitytest (3245) 于 Verbose “二 Qr 


45/com.example.activitytest D/BaseActivity: FirstActivity 
45/com.example.activitytest D/BaseActivity: SecondActivity 
45/com.example.activitytest D/BaseActivity: ThirdActivity 


图 3.44 BaseActivity 中 的 打印 日 志 


现在 每 当 我 们 进入 一 个 Activity 的 界面 ， 该 Activity 的 类 名 就 会 被 打印 出 来 ， 这 样 我 们 就 可 以 时 
刻 知 晓 当 前 界面 对 应 的 是 哪 一 个 Activity 了 。 


3.6.2 ”随时 随地 退出 程序 


如 果 目 前 你 手机 的 界面 还 停留 在 ThirdActivity， 你 会 发 现 当 前 想 退 出 程序 是 非常 不 方便 的 ， 需 
要 连 按 3 次 Back 键 才 行 。 按 Home 键 只 是 把 程序 挂 起 ， 并 没有 退出 程序 。 如 果 我 们 的 程序 需要 
注销 或 者 退出 的 功能 该 怎么 办 呢 ? 看 来 要 有 一 个 随时 随地 都 能 退出 程序 的 方案 才 行 。 


其 实 解 决 思路 也 很 简单 ， 只 需要 用 一 个 专门 的 集合 对 所 有 的 Activity 进 行 管理 就 可 以 了 。 下 面 我 
们 就 来 实现 一 下 。 


新 建 一 个 单 例 类 ActivityCoLLector 作 为 Activity 的 集合 ， 代 码 如 下 所 示 : 


object ActivityCollector { 
private val activities = ArrayList<Activity>() 


fun addActivity(activity: Activity) { 
activities.add(activity) 
} 


fun removeActivity(activity: Activity) { 
activities.remove(activity) 


fun finishALL() { 
for (activity in activities) { 
if (!activity.isFinishing) { 
activity.finish() 
} 


} 


activities.clear() 
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这 里 使 用 了 单 例 类 ， 是 因为 全 局 只 需要 一 个 Activity 集 合 。 在 集合 中 ， 我 们 通过 一 个 ArrayList 
来 暂 存 Activity， 然 后 提供 了 一 个 addActivity() 方 法 ， 用 于 向 ArrayList 中 添加 Activity ; 提 
供 了 一 个 removeActivity() 方 法 ,用 于 从 ArrayList 中 移 除 Activity ; 最 后 提供 了 一 个 
finishALL() 方 法 ,用 于 将 ArrayList 中 存储 的 Activity 全 部 销毁 。 注 意 在 销毁 Activity 之 前 ， 
我 们 需要 先 调用 activity .isFinishing 来 判断 Activity 是 否 正在 销毁 中 ， 因 为 Activity 还 可 
能 通过 按 下 Back 键 等 方式 被 销毁 ， 如果 该 Activity 没 有 正在 销毁 中 ， 我 们 再 去 调用 它 的 
finish() 方 法 来 销毁 它 。 


接 下 来 修改 BaseActivity 中 的 代码 ,如 下 所 示 : 


open class BaseActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("BaseActivity", javaClass.simpleName) 
ActivityCollector.addActivity(this) 

} 


override fun onDestroy() { 
super.onDestroy() 
ActivityCollector.removeActivity(this) 


} 


在 BaseActivity 的 onCreate( ) 方 法 中 调用 了 ActivityCoLLector 的 addActivity() 方 
法 ， 表 明 将 当前 正在 创建 的 Activity 添 加 到 集合 里 。 然 后 在 BaseActivity 中 重 写 
onDestroy () 方 法 ， 并 调用 了 ActivityCoLLector 的 removeActivity() 方 法 ,表明 从 集 
合 里 移 除 一 个 马上 要 销毁 的 Activity。 


从 此 以 后 ， 不 管 你 想 在 什么 地 方 退出 程序 , 只 需要 调用 ActivityCoLLector,finishALL( ) 
方法 就 可 以 了 。 例 如 在 ThirdActivity 界 面 想 通过 点 击 按钮 直接 退出 程序 ， 只 需 将 代码 改 成 如 下 
形式 : 


class ThirdActivity : BaseActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d("ThirdActivity", "Task id is $taskId") 
setContentView(R.layout.third layout) 
button3.setOnClickListener { 
ActivityCollector.finishAll() 
} 


} 


当然 你 还 可 以 在 销毁 所 有 Activity 的 代码 后 面 再 加 上 杀 掉 当前 进程 的 代码 ， 以 保证 程序 完全 退 
出 ， 杀 掉 进 程 的 代码 如 下 所 示 : 


android.os.Process.kiLLProcess(android.os.Process.myPid()) 
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kiLLProcess () 方 法 用 于 杀 掉 一 个 进程 ， 它 接收 一 个 进程 id 参数 ,我 们 可 以 通过 myPid ( ) 方 
法 来 获得 当前 程序 的 进程 id。 需要 注意 的 是 ,kiLLProcess () 方 法 只 能 用 于 杀 掉 当前 程序 的 
进程 ， 不 能 用 于 杀 掉 其 他 程序 。 


3.6.3 ”启动 Activity 的 最 佳 写法 


启动 Activity 的 方法 相信 你 已 经 非常 熟悉 了 ， 首先 通过 Intent 构 建 出 当前 的 “意图 ”，, 然后 调用 
startActivity() 或 startActivityForResult() 方 法 将 Activity 启 动 起 来 ， 如 果 有 数据 
需要 在 Activity 之 间 传递 ， 也 可 以 借助 Intent 来 完成 。 


假设 SecondActivity 中 需要 用 到 两 个 非常 重要 的 字符 串 参数 ， 在 启动 SecondActivity 的 时 候 必 
须 传递 过 来 ， 那 么 我 们 很 容易 会 写 出 如 下 代码 : 


val intent = Intent(this, SecondActivity::class.java) 
intent.putExtra("paraml", "datal") 
intent.putExtra("param2", "data2") 
startActivity(intent) 


虽然 这 样 写 是 完全 正确 的 ， 但 是 在 真正 的 项 目 开发 中 经 常会 出 现 对 接 的 问题 。 比 如 
SecondActivity 并 不 是 由 你 开发 的 ， 但 现在 你 负责 开发 的 部 分 需要 启动 SecondActivity ，, 而 你 
却 不 清楚 启动 SecondActivity 需 要 传递 哪些 数据 。 这 时 无 非 就 有 两 个 办 法 : 一 个 是 你 自己 去 阅 
读 SecondActivity 中 的 代码 ， 另 一 个 是 询问 负责 编写 SecondActivity 的 同事 。 你 会 不 会 觉得 很 
麻烦 呢 ? 其 实 只 需要 换 一 种 写法 ， 就 可 以 轻松 解决 上 面 的 窘境 。 


修改 SecondActivity 中 的 代码 ， 如 下 所 示 : 


class 9econdActivity : BaseActivity() { 


companion object { 
fun actionStart(context: Context, datal: String, data2: String) { 
val intent = Intent(context, SecondActivity::class.java) 
intent.putExtra("paraml", datal) 
intent.putExtra("param2", data2) 
context.startActivity(intent) 
} 
} 


} 


在 这 里 我 们 使 用 了 一 个 新 的 语法 结构 companion object ,并 在 companion object 中 定义 
了 一 个 actionStart() 方 法 。 之 所 以 要 这 样 写 ， 是 因为 Kotlin 规 定 ， 所 有 定义 在 companion 
object 中 的 方法 都 可 以 使 用 类 似 于 Java 静 态 方法 的 形式 调用 。 关 于 companion object 的 更 
多 内 容 ， 我 会 在 本 章 的 Kotlin 课 堂 中 进行 讲解 。 


接 下 来 我 们 重点 看 actionStart ( ) 方 法 ， 在 这 个 方法 中 完成 了 Intent 的 构建 ， 另 外 所 有 
SecondActivity 中 需要 的 数据 都 是 通过 actionStart () 方 法 的 参数 传递 过 来 的 ， 然 后 把 它们 
存储 到 Intent 中 ， 最 后 调用 startActivity() 方 法 启动 SecondActivity。 


这 样 写 的 好 处 在 哪里 呢 ? 最 重要 的 一 点 就 是 一 目 了 然 ，SecondActivity 所 需要 的 数据 在 方法 参 
数 中 全 部 体现 出 来 了 ， 这 样 即使 不 用 阅读 SecondActivity 中 的 代码 ,不 去 询问 负责 编写 
SecondActivity 的 同事 ， 你 也 可 以 非常 清晰 地 知道 启动 SecondActivity 需 要 传递 哪些 数据 。 另 
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外 ,这样 写 还 简化 了 启动 Activity 的 代码 ， 现 在 只 需要 一 行 代码 就 可 以 启动 SecondActivity ， 
如 下 所 示 : 


button1l1.setOnCLickListener { 


SecondActivity.actionStart(this, "datal", "data2") 
} 


养 成 一 个 良好 的 习惯 ， 给 你 编写 的 每 个 Activity 都 添加 类 似 的 启动 方法 ， 这样 不 仅 可 以 让 启动 
Activity 变 得 非常 简单 ， 还 可 以 节省 不 少 你 同事 过 来 询问 你 的 时 间 。 
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3.7 ”Kotlin 课 堂 : 标准 函数 和 静态 方法 


现在 我 们 即将 进入 本 书 首次 的 Kotlin 课 堂 ， 之 后 的 几乎 每 一 章 中 都 会 有 这 样 一 个 环节 。 虽 说 目前 
你 已 经 可 以 上 手 Kotlin 编 程 了 ， 但 我 们 只 是 在 第 2 章 中 学 习 了 一 些 Kotlin 的 基础 知识 而 已 ， 其 实 
还 有 许多 的 高 级 技巧 并 没有 涉猎 。 因 此 每 章 的 Kotlin 课 党 里， 我 都 会 结合 所 在 章节 的 内 容 ， 拓 展 
出 更 多 Kotlin 的 使 用 技巧 ， 这 将 会 是 你 提升 自己 Kotlin 水 平 的 绝 佳 机 会 。 


3.7.1 标准 函数 with、run 和 appLy 


Kotlin 的 标准 函数 指 的 是 Standard.kt 文 件 中 定义 的 函数 ， 任 何 Kotlin 代 码 都 可 以 自由 地 调用 所 
有 的 标准 旺 数 。 


虽说 标准 函数 并 不 多 ， 但 是 想 要 一 次 性 全 部 学 完 还 是 比较 吃力 的 ， 因 此 这 里 我 们 主要 学 习 几 个 
最 常用 的 标准 水 数 。 


首先 在 上 一 章 中 ， 我 们 已 经 学 习 了 Let 这 个 标准 函数 ， 它 的 主要 作用 就 是 配合 ? ,操作 符 来 进行 
辅助 判 空 处 理 ， 这 里 就 不 再 袭 述 了 。 


下 面 我 们 从 with 少 数 开始 学 起 。with 莉 数 接收 两 个 参数 : 第 一 个 参数 可 以 是 一 个 任意 类 型 的 对 
象 ， 第 二 个 参数 是 一 个 Lambda 表 达 式 。with 闹 数 会 在 Lambda 表 达 式 中 提供 第 一 个 参数 对 象 
的 上 下 文 ， 并 使 用 Lambda 表 达 式 中 的 最 后 一 行 代 码 作为 返回 值 返 回 。 示 例 代 码 如 下 : 


val result = with(obj) { 
// 这 里 是 obj 的 上 下 文 
"value"” // with 函数 的 返回 值 


} 


那么 这 个 函数 有 什么 作用 呢 ? 它 可 以 在 连续 调用 同一 个 对 象 的 多 个 方法 时 让 代码 变 得 更 加 精 
简 ,下 面 我 们 来 看 一 个 具体 的 例子 。 


比如 有 一 个 水 果 列 表 ， 现 在 我 们 想 吃 完 所 有 水 果 ， 并 将 结果 打印 出 来 ， 就 可 以 这 样 写 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
val builder = StringBuilder() 
builder.append("Start eating fruits.\n") 
for (fruit in list) { 
builder.append(fruit).append("\n") 


} 

builder.append("Ate all fruits.") 
val result = builder.toString() 
println(result) 


这 段 代 码 的 逻辑 很 简单 ， 就 是 使 用 StringBuiLder 来 构建 吃水 果 的 字符 串 ， 最 后 将 结果 打印 出 
来 。 如 果 运 行 一 下 上 述 代码 ， 那 么 一 定 会 得 到 如 图 3.45 所 示 的 打印 结果 。 
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com.example.helloworld.LearnKotlinKt 


"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
Start eating fruits. 

Apple 

Banana 

Orange 

Pear 

Grape 

Ate all fruits， 


le dl 


ml 呈 ! 


本 Process finished with exit code 0 


图 3.45 吃水 果 字符 串 的 打印 结果 


仔细 观察 上 述 代 码 ， 你 会 发 现 我 们 连续 调用 了 很 多 次 builder 对 象 的 方法 。 其 实 这 个 时 候 就 可 
以 考虑 使 用 with 函数 来 让 代码 变 得 更 加 精简 ， 如 下 所 示 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
val result = with(StringBuilder()) { 
append("Start eating fruits.\n") 
for (fruit in list) { 
append(fruit).append("\n") 


append("Ate all fruits.") 
toString() 


println(result) 


这 上段 代码 乍 一 看 可 能 有 点 迷惑 性 ， 其实 很 好 理解 。 首 先 我 们 给 with 也 数 的 第 一 个 参数 传 入 了 一 
个 StringBuilder 对 象 ， 那么 接 下 来 整个 Lambda 表 达 式 的 上 下 文 就 会 是 这 个 
StringBuiLder 对 象 。 于 是 我 们 在 Lambda 表 达 式 中 就 不 用 再 像 刚 才 那 样 调 用 
builder.append() 和 builder.toString() 方 法 了 ,而 是 可 以 直接 调用 append() 和 
toString() 方 法 。Lambda 表 达 式 的 最 后 一 行 代 码 会 作为 with 阴 数 的 返回 值 返回 ,最终 我 们 
将 结果 打印 出 来 。 


这 两 段 代 码 的 执行 结果 是 一 模 一 样 的 ， 但 是 明显 第 二 段 代 码 的 写法 更 加 简洁 一 些 ， 这 就 是 with 
咀 数 的 作用 。 


下 面 我 们 再 来 学 习 另 外 一 个 常用 的 标准 函数 : run 函 数 。 run 函 数 的 用 法 和 使 用 场景 其 实 和 
with 函数 是 非常 类 似 的 ， 只 是 稍微 做 了 一 些 语法 改动 而 已 。 首 先 run 未 数 通 常 不 会 直接 调用 ， 
而 是 要 在 某 个 对 象 的 基础 上 调用 ; 其 次 run 函 数 只 接收 一 个 Lambda 参 数 ， 并 且 会 在 Lambda 表 
达 式 中 提供 调用 对 象 的 上 下 文 。 其 他 方面 和 with 范 数 是 一 样 的 ， 包 括 也 会 使 用 Lambda 表 达 式 
中 的 最 后 一 行 代码 作为 返回 值 返回 。 示 例 代 码 如 下 : 


val result = obj.run { 
// 这 里 是 obj 的 上 下 文 
"value"”// run 函 数 的 返回 值 


} 


那么 现在 我 们 就 可 以 使 用 run 隙 数 来 修改 一 下 吃水 果 的 这 段 代码 ,如 下 所 示 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
val result = StringBuilder().run { 

append("Start eating fruits.\n") 

for (fruit in list) { 


www.blogss.cn 


append(fruit).append("\n") 


append("Ate all fruits.") 
toString() 


} 
println(result) 


总 体 来 说 变化 非常 小 , 只 是 将 调用 with 浮 数 并 传 入 StringBuiLder 对 象 改 成 了 调用 
stringBuiLder 对 象 的 run 方 法 ， 其 他 都 没有 任何 区 别 ， 这 两 段 代码 最 终 的 执行 结果 是 完全 相 
同 的 。 


最 后 我 们 再 来 学 习 标 准 函 数 中 的 appLy 函 数 。appLy 函 数 和 run 函 数 也 是 极其 类 似 的 ， 都 要 在 某 
个 对 象 上 调用 ， 并且 只 接收 一 个 Lambda 参 数 ， 也 会 在 Lambda 表 达 式 中 提供 调用 对 象 的 上 下 
文 ， 但 是 apply 也 数 无 法 指定 返回 值 ， 而 是 会 自动 返回 调用 对 象 本 身 。 示 例 代码 如 下 : 


val result = obj.apply { 
// 这 里 是 obj 的 上 下 文 


} 
// result == obj 


那么 现在 我 们 再 使 用 apply 少 数 来 修改 一 下 吃水 果 的 这 上段 代码 ,如 下 所 示 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
val result = StringBuilder().apply { 
append("Start eating fruits.\n") 
for (fruit in list) { 
append(fruit).append("\n") 


append("Ate all fruits.") 


} 
println(result.toString()) 


注意 这 里 的 代码 变化 ， 由 于 apply 哨 数 无 法 指定 返回 值 ， 只 能 返回 调用 对 象 本 身 ， 因 此 这 里 的 
result 实 际 上 是 一 个 StringBuilder 对 和 象 ， 0 
toString() 方 法 才 行 。 这 段 代码 的 执行 结果 和 前 面 两 段 仍然 是 完全 相同 的 ， 我 就 不 再 重复 演 
示 了 。 


这 样 我 们 就 将 Kotlin 中 最 常用 的 几 个 标准 函数 学 完了 ， 你 会 发 现 其 实 wvith、run 和 apptLy 这 几 
个 函数 的 用 法 和 使 用 场景 是 非常 类 似 的 。 在 大 多 数 情况 下 , 它们 可 以 相互 转换 ， 但 你 最 好 还 是 
要 掌握 它们 之 间 的 区 别 ， 以便 在 编程 时 能 够 作出 最 佳 的 选择 。 


回想 一 下 刚刚 在 最 佳 实践 环节 编写 的 启动 Activity 的 代码 : 


val intent = Intent(context, SecondActivity::class.java) 
intent.putExtra("paraml", "datal") 
intent.putExtra("param2", "data2") 
context.startActivity(intent) 


这 里 每 传递 一 个 参数 就 要 调用 一 次 intent .putExtra() 方 法 ,如 果 要 传递 10 个 参数 ， 那 就 得 
调用 10 次 。 对 于 这 种 情况 ， 我 们 就 可 以 使 用 标准 消 数 来 对 代码 进行 精简 ， 如 下 所 示 : 


val intent = Intent(context, SecondActivity::class.java).apply { 
putExtra("paraml", "datal") 
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putExtra("param2", "data2") 


context.startActivity(intent) 


可 以 看 到 ， 由 于 Lambda 表 达 式 中 的 上 下 文 就 是 Intent 对 象 ， 所 以 我 们 不 再 需要 调用 
intent.putExtra() 方 法 , 而 是 直接 调用 putExtra() 方 法 就 可 以 了 。 传 递 的 参数 越 多 ,这 
种 写法 的 优势 也 就 越 明 显 。 


好 了 ,关于 Kotlin 的 标准 函数 就 讲 到 这 里 ， 本 书后 面 的 章节 中 还 将 会 有 大 量 使 用 标准 范 数 的 代码 
示例 ， 到 时 候 你 会 对 它们 掌握 得 越 来 越 熟练 。 

3.7.2 定义 静态 方法 

静态 方法 在 某 些 编程 语言 里 面 又 叫 作 类 方法 ， 指 的 就 是 那 种 不 需要 创建 实例 就 能 调用 的 方法 ， 
所 有 主流 的 编程 语言 都 会 支持 静态 方法 这 个 特性 。 

在 java 中 定义 一 个 静态 方法 非常 简单 ， 只 需要 在 方法 上 声明 一 个 static 关 键 字 就 可 以 了 ， 如 下 
所 示 : 

public class Util { 


public static void doAction() { 
System.out.println("do action"); 


} 


这 是 一 个 非常 简单 的 工具 类 ， 上 述 代码 中 的 doAction ( ) 方 法 就 是 一 个 静态 方法 。 调 用 静态 方 
法 并 不 需要 创建 类 的 实例 ， 而 是 可 以 直接 以 Util .doAction () 这 种 写法 来 调用 。 因 而 静态 方 
法 非常 适合 用 于 编写 一 些 工具 类 的 功能 ， 因 为 工具 类 通常 没有 创建 实例 的 必要 ， 基 本 是 全 局 通 
用 的 。 


但 是 和 绝 大 多 数 主 流 编程 语言 不 同 的 是 ，Kotlin 却 极度 弱化 了 静态 方法 这 个 概念 ， 想 要 在 Kotlin 
中 定义 一 个 静态 方法 反倒 不 是 一 件 容 易 的 事 。 

那么 Kotlin 为 什么 要 这 样 设计 呢 ? 因为 Kotlin 提 供 了 比 静 态 方法 更 好 用 的 语法 特性 ， 并 且 我 们 在 
上 一 节 中 已 经 学 习 过 了 ， 那 就 是 单 例 类 。 


像 工具 类 这 种 功能 ， 在 Kotlin 中 就 非常 推荐 使 用 单 例 类 的 方式 来 实现 ， 比 如 上 述 的 UtitL 工 具 
类 ， 如果 使 用 Kotlin 来 实现 的 话 就 可 以 这 样 写 : 


object Util { 


fun doAction() { 
println("do action") 


} 


虽然 这 里 的 doAction( ) 方 法 并 不 是 静态 方法 ， 但 是 我 们 仍然 可 以 使 用 UtiL.doAction() 的 
方式 来 调用 ,这 就 是 单 例 类 所 带 来 的 便利 性 。 
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不 过 ， 使 用 单 例 类 的 写法 会 将 整个 类 中 的 所 有 方法 全 部 变 成 类 似 于 静态 方法 的 调用 方式 ， 而 如 
果 我 们 只 是 希望 让 类 中 的 某 一 个 方法 变 成 静态 方法 的 调用 方式 该 怎么 办 呢 ? 这 个 时 候 就 可 以 使 
用 刚刚 在 最 佳 实践 环节 用 到 的 Companion object 了 , 示例 如 下 : 


class UtiL { 
fun doAction1() { 
println("do action1") 
companion object { 


fun doAction2() { 
println("do action2") 


} 


这 里 首先 我 们 将 Util 从 单 例 类 改 成 了 一 个 普通 类 ， 然后 在 类 中 直接 定义 了 一 个 doAction1() 
方法 , 又 在 companion object 中 定义 了 一 个 doAction2() 方 法 。 现 在 这 两 个 方法 就 有 了 本 
质 的 区 别 ， 因 为 doAction1() 方 法 是 一 定 要 先 创建 Util 类 的 实例 才能 调用 的 ,而 
doAction2() 方 法 可 以 直接 使 用 Util.doAction2( ) 的 方式 调用 ， 


不 过 ,doAction2( ) 方 法 其 实 也 并 不 是 静态 方法 , companion object 这 个 关键 字 实际 上 会 
在 Utit 类 的 内 部 创建 一 个 伴生 类 ， 而 doAction2 ( ) 方 法 就 是 定义 在 这 个 伴生 类 里 面 的 实例 方 
法 。 只 是 Kotlin 会 保证 Util 类 始终 只 会 存在 一 个 伴生 类 对 和 象 ， 因 此 调用 Util.doAction2() 方 
法 实际 上 就 是 调用 了 Uti1l 类 中 伴生 对 象 的 doAction2() 方 法 。 
由 此 可 以 看 出 ，Kotlin 确 实 没有 直接 定义 静态 方法 的 关键 字 ， 但 是 提供 了 一 些 语法 特性 来 支持 类 
似 于 静态 方法 调用 的 写法 ， 这 些 语法 特性 基本 可 以 满足 我 们 平时 的 开发 需求 了 。 
然而 如 果 你 确 确实 实 需要 定义 真正 的 静态 方法 ，Kotlin 仍 然 提 供 了 两 种 实现 方式 : 注解 和 顶层 
方法 。 下 面 我 们 来 逐个 学 习 一 下 。 
先 来 看 注解 ， 前面 使 用 的 单 例 类 和 companion object 都 只 是 在 语法 的 形式 上 模仿 了 静态 方法 
的 调用 方式 ， 实 际 上 它们 都 不 是 真正 的 静态 方法 。 因 此 如 果 你 在 java 代 码 中 以 静态 方法 的 形式 
去 调用 的 话 ， 你 会 发 现 这 些 方法 并 不 存在 。 而 如 果 我 们 给 单 例 类 或 companion object 中 的 方 
法 加 上 @JvmStatic 注 解 , 那么 Kotlin 编 译 右 就 会 将 这 些 方法 编译 成 真正 的 静态 方法 ， 如 下 所 
人 小 : 
class Util { 
fun doAction1() { 
println("do action1") 
companion object { 
@JvmStatic 


fun doAction2() { 
println("do action2") 
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} 
注意 ， @JvmStatic 注 解 只 能 加 在 单 例 类 或 companion object 中 的 方法 上 ， 如 果 你 尝试 加 在 
一 个 普通 方法 上 ,会 直接 提示 语法 错误 。 

由 于 doAction2() 方 法 已 经 成 为 了 真正 的 静态 方法 ， 那 么 现在 不 管 是 在 Kotlin 中 还 是 在 Java 
中 ,都 可 以 使 用 Util.doAction2( ) 的 写法 来 调用 了 。 


再 来 看 顶层 方法 ， 顶 层 方 法 指 的 是 那些 没有 定义 在 任何 类 中 的 方法 ， 比 如 我 们 在 上 一 节 中 编写 
的 main() 方 法 。Kotlin 编 译 器 会 将 所 有 的 顶层 方法 全 部 编译 成 静态 方法 ， 因 此 只 要 你 定义 了 一 
个 顶层 方法 ， 那 么 它 就 一 定 是 静态 方法 。 


想 要 定义 一 个 顶层 方法 ， 首先 需要 创建 一 个 Kotlin 文 件 。 对 着 任意 包 名 右 击 ” New 一 Kotlin 
File/Class ，, 在 弹出 的 对 话 框 中 输入 文件 名 即 可 。 注 意 创 建 类 型 要 选择 File , 如 图 3.46 所 示 。 


@ 【3 New Kotlin File/Class 
Name: Helper 11 
Kind: Er File v 


图 3.46 创建 一 个 Kotlin 文 件 


点 击 ^“OK" 完 成 创建 ， 这 样 刚刚 的 包 名 路 径 下 就 会 出 现 一 个 Helper kt 文件 。 现 在 我 们 在 这 个 文件 
中 定义 的 任何 方法 都 会 是 顶层 方法 , 比如 这 里 我 就 定义 一 个 doSomething ( ) 方 法 吧 ,如 下 所 
小 : 


fun doSomething() { 
println("do something") 
} 


刚才 已 经 讲 过 了 ,Kotlin 编 译 器 会 将 所 有 的 顶层 方法 全 部 编译 成 静态 方法 ， 那么 我 们 要 怎么 调用 
这 个 doSomething() 方 法 呢 ? 


如 果 是 在 Kotlin 代 码 中 调用 的 话 ， 那 就 很 简单 了 ， 所 有 的 顶层 方法 都 可 以 在 任何 位 置 被 直接 调 
用 , 不 用 管 包 名 路 径 ， 也 不 用 创建 实例 ， 直接 键入 doSomething () 即 可 ， 如 图 3.47 所 示 。 


class FirstActivity : BaseActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d( tag: "FirstActivity", msg: "Task id is $taskId") 
setContentView(R,. layout, first_layout) 
dosom 
f dosomething() (com.example.activitytest) un 刘 
Press ^ 人 .to choose the selected (or first) suggestion and insert a dot afterwards >> 
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图 3.47 在 Kotlin 代 码 中 调用 doSomething() 方 法 


但 如 果 是 在 java 代 码 中 调用 ， 你 会 发 现 是 找 不 到 doSomething( ) 这 个 方法 的 ， 因 为 java 中 没 
有 顶层 方法 这 个 概念 ， 所 有 的 方法 必须 定义 在 类 中 。 那 么 这 个 doSomething() 方 法 被 藏 在 了 哪 
里 呢 ? 我 们 刚才 创建 的 Kotlin 文 件 名 叫 作 Helperkt ,于 是 Kotlin 编 译 希 会 自动 创建 一 个 叫 作 
HelperKt 的 java 类 ，doSomething ( ) 方 法 就 是 以 静态 方法 的 形式 定义 在 HelperKt 类 里 面 的 ， 
因此 在 Java 中 使 用 HelperKt .doSomething ( ) 的 与 法 来 调用 就 可 以 了 ， 如 图 3.48 所 示 。 


public class JavaTest { 


public void invokeStaticMethod() { 
HelperKt. dos| 
doSomething () vo 议 
人 Vy and 人 ^ 个 will move caret down and up in the editor >> 


} 
图 3.48 在 java 代 码 中 调用 doSomething() 方 法 


好 了 ， 关于 静态 方法 的 相关 内 容 就 学 到 这 里 。 本 小 节 中 所 学 的 知识 ， 除 了 @JvmStatic 注 解 不 
太 常用 之 外 ， 其 他 像 单 例 类 、companion object、 顶 层 方法 都 是 Kotlin 中 十 分 常用 的 技巧 ， 
希望 你 能 将 它们 牢 牢 掌握 。 
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3.8 小 结 与 反 评 


真是 好 疲惫 啊 ! 没 错 ， 学 习 了 这 么 多 的 东西 ,不 疲惫 才 怪 呢 。 但 是 ， 你 内 心 那 种 掌握 了 知识 的 

喜悦 感 相信 也 是 无 法 掩盖 的 。 本 章 的 收获 非常 多 啊 ,不 管 是 理论 型 还 是 实践 型 的 东西 都 涉及 

了 , 从 Activity 的 基本 用 法 ， 到 启动 Activity 和 传递 数据 的 方式 ， 再 到 Activity 的 生命 周期 以 及 
Activity 的 启动 模式 ， 你 几乎 已 经 学 会 了 关于 Activity 所 有 重要 的 知识 点 。 在 本 章 的 最 后 ， 还 学 
习 了 几 种 可 以 应 用 在 Activity 中 的 最 佳 实践 技巧 。 毫 不 夸张 地 说 ， 你 在 Android Activity 方 面 已 


经 算是 一 个 小 高 手 了 。 


另外 ,在 本 节 的 Kotlin 课 堂 中 我 们 还 学 习 了 Kotlin 标 准 函 数 的 用 法 ， 以 及 静态 方法 的 定义 方式 ， 

现在 你 的 Kotlin 水 平 又 得 到 了 进一步 的 提升 。 

不 过 ， 你 的 Android 旅 途 才刚 刚 开始 呢 ， 后 面 需要 学 习 的 东西 还 很 多 ， 也许 会 比 现 在 还 累 ， 一 定 

要 做 好 心理 准备 哦 。 总 体 来 说 ,我 给 你 现在 的 状态 打 满 分 ， 毕 竟 你 已 经 学 会 了 那么 多 的 东西 ， 
是 时 候 放松 一 下 了 。 自 己 适当 控制 一 下 休息 的 时 间 ,然后 我 们 继续 前 进 吧 ! 
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第 4 章 软件 也 要 拼 脸 蛋 ，UI 开 发 的 氮 氮 滴 滴 


我 一 直 认 为 程序 员 在 软件 的 审美 方面 普遍 比较 差 ， 至 少 我 个 人 就 是 如 此 。 如 果 要 追究 其 根本 原 
, 我 觉得 这 是 由 程序 员 的 工作 性 质 所 导致 的 。 每 当 我 们 看 到 一 个 软件 时 ， 不 会 像 普通 用 户 一 
样 仅仅 是 关注 一 下 它 的 界面 和 功能 。 我 们 总 是 会 不 自觉 地 思考 这 些 功 能 是 如 何 实现 的 ， 很 多 在 
普通 用 户 看 来 理 所 应 当 的 功能 ,背后 可 能 需要 非常 复杂 的 算法 来 完成 。 以 至 于 当 别 人 唾骂 一 
名 ， 这 软件 做 得 真 丑 的 时 候 ， 我们 还 可 能 赞叹 一 名 ， 这 功能 做 得 好 牛 啊 ! 


不 过 缺乏 审美 毕竟 不 是 一 件 值得 炫 滩 的 事情 ， 在 软件 开发 过 程 中 ， 界 面 设计 和 功能 开发 同样 重 
要 。 界 面 美观 的 应 用 程序 不 仅 可 以 大 大 增加 用 户 粘性 ， 还 能 帮 我 们 吸引 到 更 多 的 新 用 户 。 而 
Android 也 给 我 们 提供 了 大 量 的 UI 开发 工具 ， 只 要 合理 地 使 用 它们 ,就 可 以 编号 出 各 种 各 样 漂亮 
的 界面 。 


在 这 里 ， 我 无 法 教会 你 如 何 提升 自己 的 审美 ， 但 我 可 以 教会 你 怎样 使 用 Android 提 供 的 UI 开 发 工 
具 来 编写 程序 界面 。 想 必 你 在 上 一 章 中 反 反 复 复 地 使 用 那 几 个 按钮 都 快要 叶 了 吧 ， 本 章 我 们 就 
来 学 习 更 多 UI 开发 方面 的 知识 。 
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4.1 该 如 何 编写 程序 界面 


在 过 去 ,Android 应 用 程序 的 界面 主要 是 通过 编写 XML 的 方式 来 实现 的 。 写 XML 的 好 处 是 ， 我 
们 不 仪 能 够 了 解 界 面 背后 的 实现 原理 ， 而 且 编写 出 来 的 界面 还 可 以 具备 很 好 的 屏幕 适 配 性 。 等 
你 完全 掌握 了 使 用 XML 来 编写 界面 的 方法 之 后 ， 不 管 是 进行 高 复杂 度 的 界面 实现 ， 还 是 分 析 和 
修改 当前 现 有 的 界面 ， 对 你 来 说 都 将 是 手 到 擒 来 。 


不 过 最 近 几 年 ，Google 又 推出 了 一 个 全 新 的 界面 布局 : ConstraintLayout。 和 以 往 传统 的 布 

局 不 同 ，ConstraintLayout 不 是 非常 适合 通过 编写 XML 的 方式 来 开发 界面 ， 而 是 更 加 适合 在 可 
视 化 编辑 器 中 使 用 拖 放 控件 的 方式 来 进行 操作 ， 并 且 Android Studio 中 也 提供 了 非常 完备 的 可 
视 化 编辑 问 。 


虽然 现在 Google 官 方 更 加 推荐 使 用 ConstraintLayout 来 开发 程序 界面 ， 但 由 于 
ConstraintLayout 的 特殊 性 ， 书 中 很 难 展示 如 何 通过 可 视 化 编辑 右 来 对 界面 进行 动态 操作 。 
此 本 书 中 我 们 仍然 采用 编写 XML 的 传统 方式 来 开发 程序 界面 ， 并且 这 也 是 我 认为 你 必须 掌握 的 
基本 技能 。 至 于 ConstraintLayout , 如 果 你 有 兴趣 学 习 的 话 ， 可 以 关注 我 的 微 信 公众 号 ( 见 封 
面 ) ， 回 复 “ConstraintLayout”" 或 “约束 布局 " 即 可 ， 我 专门 写 了 一 篇 非常 详细 的 文章 来 对 
ConstraintLayout 进 行 讲解 。 


讲 了 这 么 多 理论 的 东西 ， 也 是 时 候 学 习 一 下 到 底 如 何 编写 程序 界面 了 ， 我 们 就 从 Android 中 几 种 
常见 的 控件 开始 吧 。 
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4.2 常用 控件 的 使 用 方法 


Android 给 我 们 提供 了 大 量 的 UI 控件 ， 合 理 地 使 用 这 些 控件 就 可 以 非常 轻松 地 编写 出 相当 不 错 的 
界面 ， 下面 我 们 就 挑选 几 种 常用 的 控件 ， 详 细 介 绍 一 下 它们 的 使 用 方法 。 


首先 新 建 一 个 UIWidgetTest 项 目 。 简 单 起 见 ， 我 们 还 是 允许 Android Studio 自 动 创建 
Activity，Activity 名 和 布局 名 都 使 用 默认 值 。 


4.2.1 TextView 


TextView 可 以 说 是 Android 中 最 简单 的 一 个 控件 了 ， 你 在 前 面 其实 已 经 和 它 打 过 一 些 交 道 了 。 
它 主 要 用 于 在 界面 上 显示 一 段 文本 信息 ， 比 如 你 在 第 1 章 看 到 的 Hello world ! 


下 面 我 们 就 来 看 一 看 TextView 的 更 多 用 法 , 将 activity_main.xml 中 的 代码 改 成 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/textView" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="This is TextView"/> 


</LinearLayout> 


外 面 的 LinearLayout 先 忽略 不 看 ， 在 TextView 中 我 们 使 用 android:id 给 当前 控件 定义 了 一 个 
唯一 标识 符 ， 这 个 属性 在 上 一 章 中 已 经 讲解 过 了 。 然 后 使 用 android:layout _width 和 
android:layout_height 指 定 了 控件 的 宽度 和 高 度 。Android 中 所 有 的 控件 都 具有 这 两 个 属 
性 ,可 选 值 有 3 种 : match parent、wrap_content 和 固定 值 。match parent 表 示 让 当前 
空 件 的 大 小 和 父 布局 的 大 小 一 样 ， 也 就 是 由 父 布局 来 决定 当前 控件 的 大 小 。wrap_content 表 
示 让 当前 控件 的 大 小 能 够 刚好 包含 住 里 面 的 内 容 ， 也 就 是 由 控件 内 容 决定 当前 控件 的 大 小 。 
定 值 表示 表示 给 控件 指定 一 个 固定 的 尺寸 ,单位 一 般 用 dp， 这 是 一 种 屏幕 密度 无 关 的 尺寸 单 

位 ， 可 以 保证 在 不 同 分 辨 率 的 手机 上 显示 效果 尽 可 能 地 一 致 ， 如 50 dp 就 是 一 个 有 效 的 固定 值 。 


所 以 上 面 的 代码 就 表示 让 TextView 的 宽度 和 父 布局 一 样 宽 ， 也 就 是 手机 屏幕 的 宽度 ,让 
TextView 的 高 度 足 够 包含 住 里 面 的 内 容 就 行 。 现 在 运行 程序 ,效果 如 图 4.1 所 示 。 
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图 4.1 TextView 运 行 效果 


虽然 指定 的 文本 内 容 正常 显示 了 ， 不 过 我 们 好 像 没 看 出 来 TextView 的 宽度 是 和 屏幕 一 样 宽 的 。 
其 实 这 是 由 于 TextView 中 的 文字 默认 是 居 左 上 角 对 齐 的 ， 虽然 TextView 的 宽度 充满 了 整个 屏 
幕 ， 可 是 由 于 文字 内 容 不 够 长 ， 所 以 从 效果 上 完全 看 不 出 来 。 现 在 我 们 修改 TextView 的 文字 对 
齐 方式 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/textView" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center" 
android:text="This is TextView"/> 


</LinearLayout> 
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我 们 使 用 android :gravity 来 指定 文字 的 对 齐 方式 ， 可 选 值 有 top、bottom、start、 
end、center 等 ， 可 以 用 “| "来 同时 指定 多 个 值 , 这 里 我 们 指定 的 是 "center" ,效果 等 同 
于 "center vertical|center horizontal" , 表示 文字 在 垂直 和 水 平方 向 都 居中 对 齐 。 


现在 重新 运行 程序 ,效果 如 图 4.2 所 示 。 
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图 4.2 TextView 居 中 效果 
这 也 说 明了 TextView 的 宽度 确实 是 和 屏幕 宽度 一 样 的 。 
另外 ,我 们 还 可 以 对 TextView 中 文字 的 颜色 和 大 小 进行 修改 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
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android:id="@+id/textView" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:gravity="center" 
android:textColor="#00ff00" 
android:textSize="24sp" 
android:text="This is TextView"/> 


</LinearLayout> 


通过 android:textCoLor 属 性 可 以 指定 文字 的 颜色 , 通过 android :textSize 属 性 可 以 指定 
文字 的 大 小 。 文 字 大 小 要 使 用 sp 作为 单位 ,这样 当 用 户 在 系统 中 修改 了 文字 显示 尺寸 时 ， 应 用 
程序 中 的 文字 大 小 也 会 跟着 变化 。 重 新 运行 程序 ， 效 果 如 图 4.3 所 示 。 
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This is TextView 


图 4.3 ”改变 TextView 文 字 大 小 和 颜色 的 效果 


当然 TextView 中 还 有 很 多 其 他 的 属性 ， 这 里 我 就 不 再 一 一 介绍 了 ， 你 需要 用 到 的 时 候 去 查阅 文 
档 就 可 以 了 。 
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4.2.2 Button 


Button 是 程序 用 于 和 用 户 进 行 交互 的 一 个 重要 控件 ， 相 信 你 对 这 个 控件 已 经 非常 熟悉 了 ， 因 为 
我 们 在 上 一 章 用 了 很 多 次 。 它 可 配置 的 属性 和 TextView 是 差不多 的 ， 我 们 可 以 在 
activity_ main.xml 中 这 样 加 入 Button : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Button" /> 


</LinearLayout> 


加 入 Button 之 后 的 界面 如 图 4.4 所 示 。 
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This is TextView 


BUTTON 


图 4.4 Button 运行 效果 


如 果 你 很 细心 的 话 ， 可 能 会 发 现 我 们 在 XML 中 指定 按钮 上 的 文字 明明 是 Button， 可 是 为 什么 界 
面 上 显示 的 却 是 BUTTON 呢 ? 这 是 因为 Android 系 统 默认 会 将 按钮 上 的 英文 字母 全 部 转换 成 大 
写 ， 可 能 是 认为 按钮 上 的 内 容 都 比较 重要 吧 。 如 果 这 不 是 你 想 要 的 效果 ， 可 以 在 XML 中 添加 
android:textAllCaps="false" 这 个 属性 , 这样 系 统 就 会 保留 你 指定 的 原始 文字 内 容 了 。 


接 下 来 我 们 可 以 在 MainActivity 中 为 Button 的 点 击 事件 注册 一 个 监听 器 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
button.setOnClickListener { 
// 在 此 处 添加 逻辑 
} 
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} 


这 里 调用 button 的 set0nClickListener() 方 法 时 利用 了 Java 单 抽象 方法 接口 的 特性 ， 从 而 
可 以 使 用 函数 式 API 的 写法 来 监听 按钮 的 点 击 事件 。 这 样 每 当 点 击 按钮 时 ， 就 会 执行 Lambda 表 
达 式 中 的 代码 ,我 们 只 需要 在 Lambda 表 达 式 中 添加 待 实现 的 逻辑 就 行 了 。 关 于 Java 子 数 式 API 
的 讲解 ， 可 以 参考 2.6.3 小 节 。 


除了 使 用 消 数 式 API 的 方式 来 注册 监听 器 ， 也 可 以 使 用 实现 接口 的 方式 来 进行 注册 ,代码 如 下 所 
小 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
button.setOnClickListener(this) 


} 


override fun onClick(v: View?) { 
when (v?.id) { 
R.id.button -> { 
// 在 此 处 添加 逻辑 
} 
} 
} 


} 


这 里 我 们 让 MainActivity 实 现 了 View .0nClickListener 接 口 ， 并重 写 了 onClick() 方 法 ， 
然后 在 调用 button 的 set0nClickListener() 方 法 时 将 MainActivity 的 实例 传 了 进去 。 这 样 
每 当 点 击 按钮 时 ， 就 会 执行 onCLick ( ) 方 法 中 的 代码 了 。 关 于 Kotlin 接 口 这 部 分 知识 的 讲解 可 
以 参考 2.5.3 小 节 。 


这 两 种 写法 都 可 以 实现 对 按钮 点 击 事件 的 监听 ,至 于 使 用 哪 一 种 ， 就 全 凭 你 的 喜好 了 。 


4.2.3 EditText 


EditText 是 程序 用 于 和 用 户 进行 交互 的 另 一 个 重要 控件 , 它 允 许 用 户 在 控件 里 输入 和 编辑 内 

容 ， 并 可 以 在 程序 中 对 这 些 内 容 进 行 处 理 。EditText 的 应 用 场景 应 该 算是 非常 普遍 了 ， 发 得 
信 、 发 微 博 、 聊 QQ 等 等 ， 在 进行 这 些 操作 时 ， 你 不 得 不 使 用 到 EditText。 那 我 们 来 看 一 看 如 何 
在 界面 上 加 入 EditText 吧 ,修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/editText" 
android:layout width="match parent" 
android:layout height="wrap content" 
/> 
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</LinearLayout> 


其 实 看 到 这 里 ， 估 计 你 已 经 总 结 出 Android 控 件 的 使 用 规律 了 。 用 法 都 很 相似 ， 给 控件 定义 一 个 
id ， 指 定 控件 的 宽度 和 高 度 ， 然 后 再 适当 加 入 些 控件 特有 的 属性 就 差不多 了 ， 所 以 使 用 XML 来 
编写 界面 其 实 一 点 都 不 难 。 现 在 重新 运行 一 下 程序 , EditText 就 已 经 在 界面 上 显示 出 来 了 ， 并 
且 我 们 是 可 以 在 里 面 输入 内 容 的 ， 如 图 4.5 所 示 。 


9:57 


UlWidgetTest 


This is TextView 


BUTTON 


Hello| 


》 my | Im 电 


q Ww es rr y U 六 0” p 
FS de Tognn ek 
E770V nm 


?123 , © .@ 


图 4.5 EditText 运 行 效果 

你 可 能 平时 会 留意 到 ， 一些 做 得 比较 人 性 化 的 软件 会 在 输入 框 里 显示 一 些 提示 性 的 文字 ,一旦 
用 户 输入 了 任何 内 容 ， 这些 提示 性 的 文字 就 会 消失 。 这 种 提示 功能 在 Android 里 是 非常 容易 实现 
的 ， 我 们 甚至 不 需要 做 任何 逻辑 控制 ， 因 为 系统 已 经 帮 有 我 们 都 处 理 好 了 。 修 改 
activity_main.xml , 如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/editText" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


这 里 使 用 and roid:hint 属 性 指定 了 一 段 提 示 性 的 文本 ， 然 后 重新 运行 程序 , 效果 如 图 4.6 所 
小 。 
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图 4.6 EditText 设 置 hint 效 果 
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可 以 看 到 ,EditText 中 显示 了 一 段 提 示 性 文本 ， 然 后 当 我 们 输入 任何 内 容 时 ， 这 段 文 本 就 会 自 
动 消失 。 


不 过 ， 随 着 输入 的 内 容 不 断 增 多 ，EditText 会 被 不 断 地 拉 长 。 这 是 由 于 EditText 的 高 度 指定 的 是 
wrap_content， 因 此 它 总 能 包含 住 里 面 的 内 容 ， 但 是 当 输 入 的 内 容 过 多 时 ,界面 就 会 变 得 非 
常 难看 。 我 们 可 以 使 用 android :maxLines 属 性 来 解决 这 个 问题 ， 修 改 activity_main.xml ， 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/editText" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="Type something here" 
android:maxLines="2" 
/> 


</LinearLayout> 


这 里 通过 android:maxLines 指 定 了 EditText 的 最 大 行 数 为 两 行 ， 这 样 当 输入 的 内 容 超 过 两 行 
时 ， 文 本 就 会 向 上 滚动 ， EditText 则 不 会 再 继续 拉 伸 ， 如 图 4.7 所 示 。 
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图 4.7 EditText 设 置 maxLines 效 果 


我 们 还 可 以 结合 使 用 EditText 与 Button 来 完成 一 些 功能 ， 比 如 通过 点 击 按钮 获取 EditText 中 输 


信 的 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


override fun onClick(v: View?) { 
when (v?.id) { 


R.id.button -> { 
val inputText = editText.text.toString() 


Toast.makeText(this, inputText, Toast.LENGTH SHORT).show!() 
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我 们 在 按钮 的 点 击 事件 里 调用 EditText 的 getText ( ) 方 法 获取 输入 的 内 容 ， 再 调用 
toString() 方 法 将 内 容 转换 成 字符 串 ， 最 后 使 用 Toast 将 输入 的 内 容 显示 出 来 。 


当然 ， 上 述 代 码 再 次 使 用 了 Kotlin 调 用 java Getter 和 Setter 方 法 的 语法 糖 ， 在 代码 中 好 像 调 
用 的 是 EditText 的 text 属 性 ， 实 际 上 调用 的 却 是 EditText 的 getText ( ) 方 法 。 这 种 语法 糖 虽然 
简化 了 书写 ， 但 是 不 太 利于 我 的 讲解 ， 因 此 这 里 我 有 必要 和 你 做 一 个 约定 。 


其 实 我 们 没有 必要 去 记忆 这 个 语法 糖 的 具体 规则 是 什么 样 的 ， 在 编写 代码 的 时 候 直 接 调用 它 的 
实际 方法 就 可 以 了 ，Android Studio 会 自动 在 代码 提示 中 显示 使 用 语法 糖 后 的 优化 代码 调用 ， 
如 图 4.8 所 示 。 


val inputText = editText.getText 


text (from getText()/setText()) Editable! 
textAlignment Int 
extClassifier TextClassifier 
extColors ColorStateList! 
extDirection Int 
extLocale Locale 
textLocales LocaLeList 
extMetricsParams PrecomputedText ,Params 
extScaleX Float 
extSize Float 
extView TextView! 
ardi+ahlaTavti+ CAit+ahlal 
人 Vy and ^ 个 will move caret down and up in the editor >> 区 


图 4.8 Android Studio 的 语法 糖 代码 提示 


可 以 看 到 ， 这 里 我 们 键入 的 是 getText ,但 是 代码 提示 的 第 一 条 就 是 将 它 转换 成 text ,因此 现在 
只 要 按 一 下 Enter 键 就 可 以 完成 转换 了 。 

有 了 这 个 前 提 ， 本 书后 面 在 涉及 这 种 Getter 和 Setter 方 法 调用 的 时 候 ， 我 都 会 使 用 真实 调用 
的 方式 名 来 进行 讲解 ， 虽然 和 实际 代码 看 上 去 有 可 能 会 对 不 上 ，, 但 是 你 没 必 要 在 这 个 地 方 产生 
疑惑 ,编写 代码 时 只 要 借助 Android Studio 的 代码 提示 功能 转换 一 下 就 可 以 了 。 


好 了 ， 讲 完了 题 外 话 ， 现 在 重新 运行 程序 。 在 EditText 中 输入 一 段 内 容 ， 然 后 点 击 按钮 ， 效果 
如 图 4.9 所 示 。 
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Writing something 


Writing something 


图 4.9 ”获取 EditText 中 输入 的 内 容 
4.2.4 ImageView 


ImageView 是 用 于 在 界面 上 展示 图 片 的 一 个 控件 ， 它 可 以 让 我 们 的 程序 界面 变 得 更 加 丰富 多 
彩 。 学 习 这 个 控件 需要 提前 准备 好 一 些 图 片 ， 你 可 以 自己 准备 任意 的 图 片 ,也 可 以 使 用 随 书 源 
码 附带 的 图 片 资 源 (资源 下 载 地 址 见 前 言 ) 。 图 片 通常 是 放 在 以 drawable 开 头 的 目录 下 的 ， 并 
且 要 带 上 具体 的 分 辨 率 。 现 在 最 主流 的 手机 屏幕 分 辨 率 大 多 是 xxhdpi 的 ， 所 以 我 们 在 res 目 录 下 
再 新 建 一 个 drawable-xxhdpi 目 录 ,然后 将 事先 准备 好 的 两 张 图 片 img_1.png 和 img_2.png 复 
制 到 该 目录 当中 。 


接 下 来 修改 activity_ main.xml , 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
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android:Layout width="match parent" 
android:layout height="match parent"> 


<ImageView 
android:id="@+id/imageView" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:src="@drawable/img 1" 
/> 


</LinearLayout> 


可 以 看 到 ， 这 里 使 用 android : src 属 性 给 ImageView 指 定 了 一 张 图 片 。 由 于 图 片 的 宽 和 高 都 
是 未 知 的 ， 所 以 将 ImageView 的 宽 和 高 都 设 定 为 vwrap_content， 这样 就 保证 了 不 管 图 片 的 尺 
寸 是 多 少 ， 都 可 以 完整 地 展示 出 来 。 重 新 运行 程序 ， 效 果 如 图 4.10 所 示 。 
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图 4.10 ImageView 运 行 效果 
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我 们 还 可 以 在 程序 中 通过 代码 动态 地 更 改 ImageView 中 的 图 片 ， 修 改 MainActivity 的 代码 ， 如 
下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


override fun onClick(v: View?) { 
when (v?.id) { 
R.id.button -> { 
imageView.setImageResource(R.drawable.img 2) 


} 


在 按钮 的 点 击 事件 里 ， 通 过 调用 lImageView 的 setImageResource() 方 法 将 显示 的 图 片 改 成 
img_2。 现 在 重新 运行 程序 ， 点 击 一 下 按钮 ， 就 可 以 看 到 ImageView 中 显示 的 图 片 改变 了 ,如 
图 4.11 所 示 。 
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一 


图 4.11 动态 更 改 ImageView 中 的 图 片 


4.2.5 ProgressBar 


ProgressBar 用 于 在 界面 上 显示 一 个 进度 条 ， 表 示 我 们 的 程序 正在 加 载 一 些 数据 。 它 的 用 法 也 
非常 简单 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ProgressBar 
android:id="@+id/progressBar" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
/> 
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</LinearLayout> 


重新 运行 程序 ， 会 看 到 屏幕 中 有 一 个 圆 形 进度 条 正在 旋转 ， 如 图 4.12 所 示 。 
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图 4.12 ProgressBar 运 行 效果 


这 时 你 可 能 会 问 ， 旋 转 的 进度 条 表明 我 们 的 程序 正在 加 载 数据 ， 那 数据 总 会 有 加 载 完 的 时 候 

吧 ， 如 何 才 能 让 进度 条 在 数据 加 载 完成 时 消失 呢 ? 这 里 我 们 就 需要 用 到 一 个 新 的 知识 点 : 
Android 控 件 的 可 见 属 性 。 所 有 的 Android 控 件 都 具有 这 个 属性 ， 可 以 通过 
android:visibiLity 进 行 指定 ， 可 选 值 有 3 种 : visibLe、invisibLe 和 gone。VvisibtLe 
表示 控件 是 可 见 的 ， 这 个 值 是 默认 值 ， 不 指定 android:visibiLity 时 ,控件 都 是 可 见 的 。 
invisibLe 表 示 控 件 不 可 见 ， 但 是 它 仍然 占据 着 原来 的 位 置 和 大 小 ， 可 以 理解 成 控件 变 成 透明 
状态 了 。gone 则 表示 控件 不 仅 不 可 见 ， 而 且 不 再 占用 任何 屏幕 空间 。 我 们 可 以 通过 代码 来 设置 
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控件 的 可 见 性 ， 使 用 的 是 setVisibiLity() 方 法 ,允许 传 入 View,VISIBLE、 
View.INVISIBLE 和 View.GONE 这 3 种 值 。 

接 下 来 我 们 就 来 尝试 实现 一 种 效果 : 点 击 一 下 按钮 让 进度 条 消失 ， 再 点 击 一 下 按钮 让 进度 条 出 
现 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


override fun onClick(v: View?) { 
when (v?.id) { 
R.id.button -> { 
if (progressBar.visibility == View.VISIBLE) { 
progressBar.visibility = View.GONE 
} else { 
progressBar.visibility = View.VISIBLE 


} 


在 按钮 的 点 击 事件 中 ， 我们 通过 getVisibility() 方 法 来 判断 ProgressBar 是 否 可 见 ， 如 果 
可 见 就 将 ProgressBar 隐 藏 掉 ,如果 不可 见 就 将 ProgressBar 显 示 出 来 。 重 新 运行 程序 ， 然 后 
不 断 地 点 击 按钮 ， 你 就 会 看 到 进度 条 在 显示 与 隐藏 之 间 来 回 切换 了 。 


另外 ， 我 们 还 可 以 给 ProgressBar 指 定 不 同 的 样式 ， 刚 刚 是 圆 形 进度 条 ， 通 过 style 属 性 可 以 将 
它 指 定 成 水 平 进度 条 ， 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ProgressBar 
android:id="@+id/progressBar" 
android:layout width="match parent" 
android:layout height="wrap content" 
style="?android:attr/progressBarStyleHorizontal" 
android:max="100" 
/> 


</LinearLayout> 


指定 成 水 平 进度 条 后 ， 我 们 还 可 以 通过 android :max 属 性 给 进度 条 设置 一 个 最 大 值 ， 然 后 在 代 
码 中 动态 地 更 改进 度 条 的 进度 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


override fun onClick(v: View?) { 
when (v?.id) { 
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R.id.button -> { 
progressBar.progress = progressBar.progress + 10 


} 


每 点 击 一 次 按钮 ， 我们 就 获取 进度 条 的 当前 进度 ， 然后 在 现 有 的 进度 上 加 10 作 为 更 新 后 的 进 
度 。 重 新 运行 程序 ， 点 击 数 次 按钮 后 ， 效果 如 图 4.13 所 示 。 
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图 4.13 ProgressBar 水 平 样式 效果 


4.2.6 AlertDialog 


AlertDialog 可 以 在 当前 界面 弹出 一 个 对 话 框 , 这 个 对 话 框 是 置顶 于 所 有 界面 元 素 之 上 的 , 能 
屏蔽 其 他 控件 的 交互 能 力 ， 因 此 AlertDialog 一 般 用 于 提示 一 些 非常 重要 的 内 容 或 者 警告 信息 。 
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比如 为 了 防止 用 户 误 删 重要 内 容 ， 在 删除 前 弹出 一 个 确认 对 话 框 。 下 面 我 们 来 学 习 一 下 它 的 用 
法 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


override fun onClick(v: View?) { 
when (v?.id) { 
R.id.button -> { 

AlertDialog.Builder(this).apply { 
setTitle("This is Dialog") 
setMessage("Something important.") 
setCancelable(false) 
setPositiveButton("OK") { dialog, which -> 


} 
setNegativeButton("Cancel") { dialog, which -> 


Show() 


} 


首先 通过 AlertDialog.Builder 构 建 一 个 对 话 框 ， 这 里 我 们 使 用 了 Kotlin 标 准 函数 中 的 appLy 函 
数 。 在 apply 哨 数 中 为 这 个 对 话 框 设置 标题 、 内 容 、 可 否 使 用 Back 键 关闭 对 话 框 等 属性 ， 接 下 
来 调用 setPositiveButton() 方 法 为 对 话 框 设置 确定 按钮 的 点 击 事件 ,调用 
setNegativeButton( ) 方 法 设置 取消 按钮 的 点 击 事件 ， 最 后 调用 show ( ) 方 法 将 对 话 框 显示 
出 来 就 可 以 了 。 重 新 运行 程序 , 点 击 按钮 后 ， 效 果 如 图 4.14 所 示 。 
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This is Dialog 


Something important. 


CANCEL OK 


图 4.14 AlertDialog 运 行 效果 


好 了 ,关于 Android 常 用 控件 的 使 用 ， 我 要 讲 的 就 只 有 这 么 多 。 一 节 内 容 就 想 覆 盖 Android 控 件 
所 有 的 相关 知识 不 太 现实 ， 同 样 ， 一 口气 就 想 学 会 所 有 Android 控 件 的 使 用 方法 也 不 太 现 实 。 本 
节 所 讲 的 内 容 对 于 你 来 说 只 是 起 到 了 一 个 引导 的 作用 ， 你 还 需要 在 以 后 的 学 习 和 工作 中 不 断 地 
摸索 ， 通 过 查阅 文档 以 及 网 上 搜索 的 方式 学 习 更 多 控件 的 更 多 用 法 。 当 然 ， 当 本 书后 面 涉及 一 
些 我 们 前 面 没 学 过 的 控件 和 相关 用 法 时 ， 我 仍然 会 在 相应 的 章节 做 详细 的 讲解 。 
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4.3 详解 3 种 基本 布局 


一 个 丰富 的 界面 是 由 很 多 个 控件 组 成 的 ， 那 么 我 们 如 何 才 能 让 各 个 控件 都 有 条 不 率 地 摆 放 在 界 
面 上 ， 而 不 是 乱糟糟 的 呢 ? 这 就 需要 借助 布局 来 实现 了 。 布 局 是 一 种 可 用 于 放置 很 多 控件 的 容 
器 , 它 可 以 按照 一 定 的 规律 调整 内 部 控件 的 位 置 ， 从 而 编写 出 精美 的 界面 。 当 然 ， 布 局 的 内 部 
除了 放置 控件 外 ,也 可 以 放置 布局 ,通过 多 层 布局 的 散 套 ， 我们 就 能 够 完成 一 些 比较 复杂 的 界 
面 实现 ， 图 4.15 很 好 地 展示 了 它们 之 间 的 关系 。 


控件 控件 控件 控件 


图 4.15 布局 和 控件 的 关系 


下 面 我 们 就 来 详细 学 习 一 下 Android 中 3 种 最 基本 的 布局 。 先 做 好 准备 工作 ， 新 建 一 个 
UlLayoutTest 项 目 ， 并 让 Android Studio 自 动 帮 我 们 创建 好 Activity ,Activity 名 和 布局 名 都 
使 用 默认 值 。 


4.3.1 LinearLayout 


LinearLayout 又 称 作 线 性 布局 , 是 一 种 非常 常用 的 布局 。 正 如 它 的 名 字 所 描述 的 一 样 ， 这 个 布 
局 会 将 它 所 包含 的 控件 在 线性 方向 上 依次 排列 。 相 信 你 之 前 也 已 经 注意 到 了 ， 我 们 在 上 一 节 中 
学 习 控件 用 法 时 ， 所 有 的 控件 就 都 是 放 在 LinearLayout 布 局 里 的 ， 因 此 上 一 节 中 的 控件 也 确实 
是 在 垂直 方向 上 线性 排列 的 。 


既然 是 线性 排列 ， 肯 定 就 不 只 有 一 个 方向 ， 那 为 什么 上 一 节 中 的 控件 都 是 在 垂直 方向 排列 的 
呢 ? 这 是 由 于 我 们 通过 android:orientation 属 性 指定 了 排列 方向 是 vertical ,如 果 指 定 的 
是 horizontal , 控件 就 会 在 水 平方 向 上 排列 了 。 下 面 我 们 通过 实战 来 体会 一 下 ， 修改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/buttonl" 
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android:Layout width="wrap content" 
android:layout height="wrap content" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:text="Button 3" /> 


</LinearLayout> 


我 们 在 LinearLayout 中 添加 了 3 个 Button , 每 个 Button 的 长 和 宽 都 是 wrap_content ,并 指 
定 了 排列 方向 是 vertical。 现 在 运行 一 下 程序 ， 效果 如 图 4.16 所 示 。 
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图 4.16 ”LinearLayout 垂 直 排 列 
然后 我 们 修改 一 下 LinearLayout 的 排列 方向 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


</LinearLayout> 


这 里 将 android:orientation 属 性 的 值 改 成 了 horizontal ,这 就 意味 着 要 让 
LinearLayout 中 的 控件 在 水 平方 向 上 依次 排列 。 当 然 ， 如 果 不 指定 android:orientation 
属性 的 值 ， 默 认 的 排列 方向 就 是 horizontatL。 重 新 运行 一 下 程序 , 效果 如 图 4.17 所 示 。 
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图 4.17 LinearLayout 水 平 排列 


需要 注意 ， 如 果 LinearLayout 的 排列 方向 是 horizontal , 内 部 的 控件 就 绝对 不 能 将 宽度 指定 
为 match_parent ,否则 ,单独 一 个 控件 就 会 将 整个 水 平方 向 占 满 ， 其 他 的 控件 就 没有 可 放置 
的 位 置 了 。 同 样 的 道理 ， 如果 LinearLayout 的 排列 方向 是 vertical ,内 部 的 控件 就 不 能 将 高 
度 指定 为 mnatch_parent。 


下 面 来 看 android:Layout gravity 属 性 ， 它 和 我 们 上 一 节 中 学 到 的 android:gravity 属 
性 看 起 来 有 些 相似 ， 这 两 个 属性 有 什么 区 别 呢 ? 其 实 从 名 字 就 可 以 看 出 ，android:gravity 
用 于 指定 文字 在 控件 中 的 对 齐 方式 , 而 android:Layout gravity 用 于 指定 控件 在 布局 中 的 
对 齐 方式 。android:Layout gravity 的 可 选 值 和 android :gravity 差 不 多 ,但 是 需要 注 
意 , 当 LinearLayout 的 排列 方向 是 horizontaL 时 ,只 有 垂直 方向 上 的 对 齐 方式 才 会 生效 。 
为 此 时 水 平方 向 上 的 长 度 是 不 固定 的 ， 每 添加 一 个 控件 ,水 平方 向 上 的 长 度 都 会 改变 ， 因 而 无 
法 指定 该 方向 上 的 对 齐 方 式 。 同 样 的 道理 ， 当 LinearLayout 的 排列 方向 是 vertical 时 ,只 
水 平方 向 上 的 对 齐 方式 才 会 生效 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/buttonl" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:Layout gravity="top" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="bottom" 
android:text="Button 3" /> 


</LinearLayout> 


由 于 目前 LinearLayout 的 排列 方向 是 horizontaL， 因此 我 们 只 能 指定 垂直 方向 上 的 排列 方 
向 ,将 第 一 个 Button 的 对 齐 方式 指定 为 top， 第 二 个 Button 的 对 齐 方式 指定 为 
center_vertical , 第 三 个 Button 的 对 齐 方式 指定 为 bottom。 重 新 运行 程序 , 效果 如 图 
4.18 所 示 。 
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图 4.18 指定 layout _ gravity 的 效果 


接 下 来 我 们 学 习 LinearLayout 中 的 另 一 个 重要 属性 一 一 android:Layout_weight。 这 个 属 
性 允许 我 们 使 用 比例 的 方式 来 指定 控件 的 大 小 ， 它 在 手机 屏幕 的 适 配 性 方面 可 以 起 到 非常 重要 
的 作用 。 比 如 , 我 们 正在 编写 一 个 消息 发 送 界 面 ，, 需要 一 个 文本 编辑 框 和 一 个 发 送 按钮 ， 修改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<EditText 
android:id="@+id/input message" 
android:Layout width="Qdp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:hint="Type something" 
/> 
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<Button 
android:id="@+id/send" 
android:Layout width="0dp" 
android:Layout height="wrap content" 
android:layout weight="1" 
android:text="Send" 
/> 


</LinearLayout> 


你 会 发 现 ， 这 里 竟然 将 EditText 和 Button 的 宽度 都 指定 成 了 0 dp， 这 样 文本 编辑 框 和 按钮 还 能 
显示 出 来 吗 ?不 用 担心 ， 由 于 我 们 使 用 了 android:Layout weight 属 性 ， 此 时 控件 的 宽度 就 
不 应 该 再 由 android:Layout_width 来 决定 了 ,这 里 指定 成 0 dp 是 一 种 比较 规范 的 写法 。 


然后 在 EditText 和 Button 里 将 android:Layout_weight 属 性 的 值 指定 为 1 , 这 表示 EditText 
和 Button 将 在 水 平方 向 平分 宽度 。 


重新 运行 程序 ， 你 会 看 到 如 图 4.19 所 示 的 效果 。 
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UlLayoutTest 


图 4.19 指定 Llayout_weight 的 效果 


为 什么 将 android:Layout_weight 属 性 的 值 同 时 指定 为 1 就 会 平分 屏幕 宽度 呢 ? 其 实 原理 很 
简单 ， 系 统 会 先 把 LinearLayout 下 所 有 控件 指定 的 Layout_weight 值 相 加 ， 得 到 一 个 总 值 ， 
然后 每 个 控件 所 占 大 小 的 比例 就 是 用 该 控件 的 Layout_weight 值 除 以 刚才 算出 的 总 值 。 因 此 如 
果 想 让 EditText 占 据 屏 幕 宽 度 的 3/5 ，Button 占 据 屏幕 宽度 的 2/5 ， 只 需要 将 EditText 的 
Layout weight 改 成 3, Button 的 Llayout weight 改 成 2 就 可 以 了 。 


我 们 还 可 以 通过 指定 部 分 控件 的 Layout_weight 值 来 实现 更 好 的 效果 。 修 改 activity_main. 
xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 
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<EditText 


/> 


<Button 


/> 


</LinearLayout> 


android: 
android: 
android: 
android: 
android: 


android: 
android: 
android: 
android: 


id="@+id/input message" 
Layout width="0dp" 

layout height="wrap_content" 
layout weight="1" 

hint="Type something" 


id="@+id/send" 

layout width="wrap_ content" 
layout height="wrap content" 
text="Send" 


这 里 我 们 仅 指 定 了 EditText 的 android:layout weight 属 性 ,并 将 Button 的 宽度 改 回 了 
wrap_content。 这 表示 Button 的 宽度 仍然 按照 wrap_content 来 计算 ， 而 EditText 则 会 占 满 
屏幕 所 有 的 剩余 空间 。 使 用 这 种 方式 编写 的 界面 ， 不 仅 可 以 适 配 各 种 屏幕 ， 而 且 看 起 来 也 更 加 
舒服 。 重 新 运行 程序 ,效果 如 图 4.20 所 示 。 
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hypesomething SEND 


图 4.20 使 用 Layout_weight 实 现 宽度 自 适 配 效 果 


4.3.2 RelativeLayout 


RelativeLayout 又 称 作 相对 布局 , 也 是 一 种 非常 常用 的 布局 。 和 LinearLayout 的 排列 规则 不 
同 , RelativeLayout 显 得 更 加 随意 ， 它 可 以 通过 相对 定位 的 方式 让 控件 出 现在 布局 的 任何 位 
置 。 也 正 因为 如 此 ，RelativeLayout 中 的 属性 非常 多 ,不 过 这 些 属性 都 是 有 规律 可 循 的 ， 其实 
并 不 难 理解 和 记忆 。 我 们 还 是 通过 实践 来 体会 一 下 ， 修改 activity_main.xml 中 的 代码 ， 如 下 所 
修 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/buttonl" 
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android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout alignParentLeft="true" 
android:layout alignParentTop="true" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout alignParentRight="true" 
android:layout alignParentTop="true" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button3" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:text="Button 3" /> 


<Button 
android:id="@+id/button4" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:layout alignParentLeft="true" 
android:text="Button 4" /> 


<Button 
android:id="@+id/button5" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true 
android:layout alignParentRight="true" 
android:text="Button 5" /> 


</RelativeLayout> 


以 上 代码 不 需要 做 过 多 解释 ， 因 为 实在 是 太 好 理解 了 。 我 们 让 Button 1 和 父 布局 的 左上 角 对 
齐 ，Button 2 和 父 布局 的 右上 角 对 齐 ，Button 3 居中 显示 ， Button 4 和 父 布局 的 左下 角 对 齐 ， 
Button 5 和 父 布局 的 右 下 角 对 齐 。 虽 然 android:Layout alignParentLeft、 
android:Layout alLignParentTop、android:Layout alLignParentRight、 
android:Layout _aLignParentBottom、android:Layout_centerInParent 这 几 个 属 
性 我 们 之 前 都 没 接触 过 ， 可 是 它们 的 名 字 已 经 完全 说 明了 它们 的 作用 。 重 新 运行 程序 , 效果 如 
图 4.21 所 示 。 
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BUTTON 1 BUTTON 2 
BUTTON 3 

BUTTON 4 BUTTON 5 


图 4.21 相对 于 父 布 局 定位 的 效果 


上 面 例子 中 的 每 个 控件 都 是 相对 于 父 布局 进行 定位 的 ， 那 控件 可 不 可 以 相对 于 控件 进行 定位 
呢 ? 当然 是 可 以 的 ,修改 activity_main.xml 中 的 代码 ,如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button3" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerIinParent="true" 
android:text="Button 3" /> 


<Button 
android:id="@+id/button1" 
android:layout width="wrap content" 
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android:Layout height="wrap content" 
android:layout above="@id/button3" 
android:Layout toLeft0f="@id/button3" 
android:text="Button 1" /> 


<Button 
android:id="@+id/button2" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout above="@id/button3" 
android:Layout toRight0f="@id/button3" 
android:text="Button 2" /> 


<Button 
android:id="@+id/button4" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout below="@id/button3" 
android:Layout toLeft0f="@id/button3" 
android:text="Button 4" /> 


<Button 
android:id="@+id/button5" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout below="@id/button3" 
android:Layout toRight0f="@id/button3" 
android:text="Button 5" /> 


</RelativeLayout> 


这 次 的 代码 稍微 复杂 一 点 ， 不 过 仍然 是 有 规律 可 循 的 。android:tLayout_above 属 性 可 以 让 
一 个 控件 位 于 另 一 个 控件 的 上 方 ， 需 要 为 这 个 属性 指定 相对 控件 id 的 引用 ， 这 里 我 们 填 入 了 
G@id/button3， 表 示 让 该 控件 位 于 Button 3 的 上 方 。 其 他 的 属性 也 是 相似 的 ,android: 
Layout_beLow 表 示 让 一 个 控件 位 于 另 一 个 控件 的 下 方 , android:Layout toLeft0f 表 示 
让 一 个 控件 位 于 另 一 个 控件 的 左 侧 , android:1layout toRight0f 表 示 让 一 个 控件 位 于 另 一 
个 控件 的 右 侧 。 注 意 ， 当 一 个 控件 去 引用 另 一 个 控件 的 id 时 ， 该 控件 一 定 要 定义 在 引用 控件 的 后 
面 ， 不然 会 出 现 找 不 到 id 的 情况 。 重 新 运行 程序 , 效果 如 图 4.22 所 示 。 
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BUTTON 1 BUTTON 2 
BUTTON 3 


BUTTON 4 BUTTON 5 


图 4.22 ”相对 于 控件 定位 的 效果 


RelativeLayout 中 还 有 另外 一 组 相对 于 控件 进行 定位 的 属性 , android:layout alignLeft 
表示 让 一 个 控件 的 左边 缘 和 另 一 个 控件 的 左边 缘 对 齐 ，android:1layout alignRight 表 示 
让 一 个 控件 的 右边 缘 和 另 一 个 控件 的 右边 缘 对 齐 。 此 外 ,还 有 android:layout alignTop 和 
android:Layout_aLignBottom，, 道理 都 是 一 样 的 ， 我 就 不 再 多 说 了 ， 这 几 个 属性 就 留 给 你 
自己 去 尝试 吧 。 


好 了 “， 正 如 我 前 面 所 说 的 ，RelativeLayout 中 的 属性 虽然 多 ,但 都 是 有 规律 可 循 的 ， 所 以 学 起 
来 一 点 都 不 觉得 吃力 吧 ? 


4.3.3 FrameLayout 


FrameLayout 又 称 作 帧 布局 , 它 相 比 于 前 面 两 种 布局 就 简单 太 多 了 “， 因 此 它 的 应 用 场景 少 了 很 
多 。 这 种 布局 没有 丰 语 的 定位 方式 ,所 有 的 控件 都 会 默认 摆 放 在 布局 的 左上 角 。 让 我 们 通过 例 
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子 来 看 一 看 吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/textView" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="This is TextView" 
/> 


<Button 
android:id="@+id/button" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:text="Button" 
/> 


</FrameLayout> 


FrameLayout 中 只 是 放置 了 一 个 TextView 和 一 个 Button。 重 新 运行 程序 ， 效果 如 图 4.23 所 
不 。 
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BUTTON 


图 4.23 FrameLayout 运 行 效果 
可 以 看 到 ,文字 和 按钮 都 位 于 布局 的 左上 角 。 由 于 Button 是 在 TextView 之 后 添加 的 ， 因 此 按钮 
压 在 了 文字 的 上 面 。 


当然 ， 除 了 这 种 默认 效果 之 外 ， 我 们 还 可 以 使 用 Layout_gravity 属 性 来 指定 控件 在 布局 中 的 
对 齐 方式 ， 这 和 LinearLayout 中 的 用 法 是 相似 的 。 修 改 activity_main.xml 中 的 代码 ,如 下 所 
示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:id="@+id/textView" 
android:layout width="wrap content" 
android:layout height="wrap _ content" 
android:Layout gravity="left" 
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android:text="This is TextView" 
/> 


<Button 
android:id="@+id/button" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:Layout gravity="right" 
android:text="Button" 
/> 


</FrameLayout> 


我 们 指定 TextView 在 FrameLayout 中 居 左 对 齐 ， 指定 Button 在 FrameLayout 中 居 右 对 齐 , 然 
后 重新 运行 程序 ， 效 果 如 图 4.24 所 示 。 
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This is TextView 
BUTTON 


图 4.24 指定 Layout_gravity 的 效果 


www.blogss.cn 


总 体 来 讲 ， 由 于 定位 方式 的 欠缺 , FrameLayout 的 应 用 场景 相对 偏 少 一 些 ， 不 过 在 下 一 章 中 介 
绍 Fragment 的 时 候 我 们 还 是 可 以 用 到 它 的 。 
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4.4 ”系统 控件 不 够 用 ? 创建 自 定义 控件 


在 前 两 节 我 们 学 习 了 Android 中 的 一 些 常用 控件 和 基本 布局 的 用 法 ， 不 过 当时 我 们 并 没有 关注 这 
些 控件 和 布局 的 继承 结构 ， 现 在 是 时 候 来 看 一 下 了 ， 如 图 4.25 所 示 。 


View 
TextView ImageView ViewGroup 
个 个 
EditText Button LinearLayout RelativeLayout | | ...... 


图 4.25 常用 控件 和 布局 的 继承 结构 


可 以 看 到 ,我们 所 用 的 所 有 控件 都 是 直接 或 间接 继承 自 View 的 ， 所 用 的 所 有 布局 都 是 直接 或 间 

接 继承 自 ViewGroup 的 。View 是 Android 中 最 基本 的 一 种 UI 组 件 ， 它 可 以 在 屏幕 上 绘制 一 块 矩 
形 区 域 ， 并 能 响应 这 块 区 域 的 各 种 事件 ， 因 此 ， 我 们 使 用 的 各 种 控件 其 实 就 是 在 View 的 基础 上 
又 添加 了 各 自 特 有 的 功能 。 而 ViewGroup 则 是 一 种 特殊 的 View , 它 可 以 包含 很 多 子 View 和 子 

ViewGroup， 是 一 个 用 于 放置 控件 和 布局 的 容器 。 


这 个 时 候 我 们 就 可 以 思考 一 下 ， 当 系统 自 带 的 控件 并 不 能 满足 我 们 的 需求 时 ， 可 不 可 以 利用 上 
面 的 继承 结构 来 创建 自 定 义 控件 呢 ? 答案 是 肯定 的 ， 下 面 我 们 就 来 学 习 一 下 创建 自 定义 控件 的 
两 种 简单 方法 。 先 将 准备 工作 做 好 ， 创建 一 个 UICustomViews 项 目 。 


4.4.1 引入 布局 


如 果 你 用 过 iPhone , 应 该 会 知道 ,iPhone 应 用 的 界面 顶部 有 一 个 标题 栏 ， 标题 栏 上 会 有 一 到 两 
个 按钮 可 用 于 返回 或 其 他 操作 (iPhone 没有 专门 的 返回 键 ) 。 现 在 很 多 Android 程 序 喜欢 模仿 
iPhone 的 风格 ， 会 在 界面 的 顶部 也 放置 一 个 标题 栏 。 虽 然 Android 系 统 已 经 给 每 个 Activity 提 
供 了 标题 栏 功 能 ， 但 这 里 我 们 决定 先 不 使 用 它 ， 而 是 创建 一 个 自 定义 的 标题 栏 。 


经 过 前 两 节 的 学 习 ， 相 信 创 建 一 个 标题 栏 布局 对 你 来 说 已 经 不 是 什么 困难 的 事情 了 ， 只 需要 加 

入 两 个 Button 和 一 个 TextView， 然 后 在 布局 中 摆 放 好 就 可 以 了 。 可 是 这 样 做 会 存在 一 个 问题 ， 
一 般 我 们 的 程序 中 可 能 有 很 多 个 Activity 需 要 这 样 的 标题 栏 ， 如 果 在 每 个 Activity 的 布局 中 都 编 
写 一 遍 同 样 的 标题 栏 代码 ， 明 显 就 会 导致 代码 的 大 量 重复 。 这 时 我 们 就 可 以 使 用 引入 布局 的 方 

式 来 解决 这 个 问题 ， 在 layout 目 录 下 新 建 一 个 title.xml 布 局 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="wrap content" 
android:background="@drawable/title bg"> 


<Button 
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android:id="@+id/titleBack" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout gravity="center" 
android:layout margin="5dp" 
android:background="@drawable/back bg" 
android:text="Back" 
android:textColor="#fff" /> 


<TextView 
android:id="@+id/titleText" 
android:Layout width="Qdp" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout weight="1" 
android:gravity="center" 
android:text="Title Text" 
android:textColor="#fff" 
android:textSize="24sp" /> 


<Button 
android:id="@+id/titleEdit" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout margin="5dp" 
android:background="@drawable/edit bg" 
android:text="Edit" 
android:textColor="#fff" /> 


</LinearLayout> 


可 以 看 到 ,我 们 在 LinearLayout 中 分 别 加 入 了 两 个 Button 和 一 个 TextView ,左边 的 Button 可 
用 于 返回 , 右边 的 Button 可 用 于 编辑 , 中 间 的 TextView 则 可 以 显示 一 段 标题 文本 。 上 面 代 码 中 
的 大 多 数 属性 是 你 已 经 见 过 的 ， 下 面 我 来 说 明 一 下 几 个 之 前 没有 讲 过 的 属性 。 

android:background 用 于 为 布局 或 控件 指定 一 个 背景 ， 可 以 使 用 颜色 或 图 片 来 进行 填充 。 这 
里 我 提前 准备 好 了 3 张 图 片 一 一 title_bg.png、back_bg.png 和 edit_bg.png (资源 下 载 地 址 见 
前 言 ) ， 分别 用 于 作为 标题 栏 、 返 回 按钮 和 编辑 按钮 的 背景 。 另 外 ,在 两 个 Button 中 我 们 都 使 

用 了 android:layout_margin 这 个 属性 , 它 可 以 指定 控件 在 上 下 左右 方向 上 的 间距 。 当 然 也 
可 以 使 用 android:Layout marginLeft 或 android:1layout marginTop 等 属性 来 单独 指 

定 控件 在 某 个 方向 上 的 间距 。 


现在 标题 栏 布 局 已 经 编写 完成 了 ， 剩 下 的 就 是 如 何在 程序 中 使 用 这 个 标题 栏 了 ， 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent" > 


<include layout="@layout/title" /> 


</LinearLayout> 


没 错 ! 我 们 只 需要 通过 一 行 incLude 语 名 引入 标题 栏 布局 就 可 以 了 。 
最 后 别 忘 了 在 MainActivity 中 将 系统 自 带 的 标题 栏 隐藏 掉 ， 代 码 如 下 所 示 : 
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class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
supportActionBar?.hide() 


} 

这 里 我 们 调用 了 getSupportActionBar() 方 法 来 获得 ActionBar 的 实例 ， 然 后 再 调用 它 的 
hide( ) 方 法 将 标题 栏 隐藏 起 来 。 由 于 ActionBar 有 可 能 为 空 , 所 以 这 里 还 使 用 了 ? .操作 符 。 关 
于 ActionBar 的 更 多 用 法 ， 我 将 会 在 第 12 章 中 讲解 ， 现 在 你 只 需要 知道 可 以 通过 这 种 写法 来 隐 


藏 标题 栏 就 足够 了 。 现 在 运行 一 下 程序 ， 效 果 如 图 4.26 所 示 。 


Title Text 


图 4.26 引入 标题 栏 布局 的 效果 
使 用 这 种 方式 ， 不 管 有 多 少 布局 需要 添加 标题 栏 , 只 需 一 行 jnclude 语 句 就 可 以 了 。 
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4.4.2 ”创建 自 定义 控件 


引入 布局 的 技巧 确实 解决 了 重复 编写 布局 代码 的 问题 ， 但 是 如 果 布 局 中 有 一 些 控件 要 求 能 够 响 
应 事件 ， 我 们 还 是 需要 在 每 个 Activity 中 为 这 些 控件 单独 编写 一 次 事件 注册 的 代码 。 比 如 标题 栏 
中 的 返回 按钮 ， 其 实 不 管 是 在 哪 一 个 Activity 中 ， 这 个 按钮 的 功能 都 是 相同 的 ， 即 销毁 当前 
Activity。 而 如 果 在 每 一 个 Activity 中 都 需要 重新 注册 一 遍 返 回 按钮 的 点 击 事件 ， 无 疑 会 增加 很 
多 重复 代码 ， 这 种 情况 最 好 是 使 用 自 定义 控件 的 方式 来 解决 。 


新 建 TitleLayout 继 承 自 LinearLayout ,让 它 成 为 我 们 自 定义 的 标题 栏 控 件 ， 代 码 如 下 所 示 : 


class TitleLayout(context: Context, attrs: AttributeSet) : LinearLayout(context, attrs) { 


init { 
LayoutInflater.from(context).inflate(R.layout.title, this) 


} 


这 里 我 们 在 TitleLayout 的 主 构造 函数 中 声明 了 Context 和 AttributeSet 这 两 个 参数 ， 在 布局 中 
引入 TitleLayout 控 件 时 就 会 调用 这 个 构造 水 数 。 然 后 在 init 结 构 体 中 需要 对 标题 栏 布局 进行 动 
态 加 载 ， 这 就 要 借助 Layoutlnflater 来 实现 了 。 通 过 Layoutlnflater 的 from( ) 方 法 可 以 构建 出 
一 个 LayoutInfLater 对 象 ， 然 后 调用 infLate( ) 方 法 就 可 以 动态 加 载 一 个 布局 文件 。 
inflate() 方 法 接收 两 个 参数 : 第 一 个 参数 是 要 加 载 的 布局 文件 的 id ， 这 里 我 们 传人 入 
R.Layout .titLe ; 第 二 个 参数 是 给 加 载 好 的 布局 再 添加 一 个 父 布局 ,这 里 我 们 想 要 指定 为 
TitleLayout ,于 是 直接 传 入 this。 


现在 自 定义 控件 已 经 创建 好 了 ， 接 下 来 我 们 需要 在 布局 文件 中 添加 这 个 自 定义 控件 ， 修改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent" > 


<com.example.uicustomviews.TitleLayout 
android:layout width="match parent" 
android:layout height="wrap content" /> 


</LinearLayout> 


添加 自 定义 控件 和 添加 普通 控件 的 方式 基本 是 一 样 的 ， 只 不 过 在 添加 自 定义 控件 的 时 候 ， 我 们 
需要 指明 控件 的 完整 类 名 ， 包 名 在 这 里 是 不 可 以 省 略 的 。 


重新 运行 程序 ， 你 会 发 现 此 时 的 效果 和 使 用 引入 布局 方式 的 效果 是 一 样 的 。 
下 面 我 们 尝试 为 标题 栏 中 的 按钮 注册 点 击 事件 ， 修 改 TitleLayout 中 的 代码 ， 如 下 所 示 : 


class TitleLayout(context: Context, attrs: AttributeSet) : LinearLayout(context, attrs) { 


init { 
LayoutInflater.from(context).inflate(R.layout.title, this) 
titleBack.setOnClickListener { 
val activity = context as Activity 
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activity.finish() 


} 
titleEdit.setOnClickListener { 
Toast.makeText(context, "You clicked Edit button", 


} 


Toast .LENGTH SHORT). show() 


} 
这 里 我 们 分 别 给 返回 和 编辑 这 两 个 按钮 注册 了 点 击 事件 ， 当 点 击 返回 按钮 时 销毁 当前 Activity ， 
当 点 击 编辑 按钮 时 弹出 一 段 文 本 。 

注意 ,TitleLayout 中 接收 的 Context 参 数 实际 上 是 一 个 Activity 的 实例 ， 在 返回 按钮 的 点 击 事 
件 里 ， 我 们 要 先 将 它 转换 成 Activity 类 型 ， 然 后 再 调用 finish ( ) 方 法 销毁 当前 的 Activity。 
Kotlin 中 的 类 型 强制 转换 使 用 的 关键 字 是 as , 由 于 是 第 一 次 用 到 ， 所 以 这 里 单独 讲解 一 下 。 


重新 运行 程序 ， 点 击 一 下 编辑 按钮 ,效果 如 图 4.27 所 示 。 点 击 返 回 按钮 ,当前 界面 就 会 立即 关 
闭 。 由 此 说 明 , 我 们 的 自 定 义 控件 确实 已 经 可 以 正常 工作 了 。 
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图 4.27 ”点击 编 辑 按钮 的 效果 


这 样 的 话 ， 每 当 我 们 在 一 个 布局 中 引入 TitleLayout 时 ， 返回 按钮 和 编辑 按钮 的 点 击 事件 就 已 经 
自动 实现 好 了 ,这 就 省 去 了 很 多 编写 重复 代码 的 工作 。 
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4.5 最 常用 和 最 难 用 的 控件 : ListView 


ListView 在 过 去 绝对 可 以 称 得 上 是 Android 中 最 常用 的 控件 之 一 ， 几 乎 所 有 的 应 用 程序 都 会 用 
到 它 。 由 于 手机 屏幕 空间 比较 有 限 ， 能 够 一 次 性 在 屏幕 上 显示 的 内 容 并 不 多 ， 当 我 们 的 程序 中 
有 大 量 的 数据 需要 展示 的 时 候 ， 就 可 以 借助 ListView 来 实现 。ListView 人 允许 用 户 通 过 手指 上 下 
滑动 的 方式 将 屏幕 外 的 数据 滚动 到 屏幕 内 ， 同 时 屏幕 上 原 有 的 数据 会 滚动 出 屏幕 。 你 其 实 每 天 
都 在 使 用 这 个 控件 ， 比 如 查看 QQ 聊天 记录 ， 翻阅 微 博 最 新 消息 ， 等 等 。 


不 过 比 起 前 面 介绍 的 几 种 控件 ，ListView 的 用 法 相对 复杂 了 很 多 ， 因 此 我 们 就 单独 使 用 一 节 内 
容 来 对 ListView 进 行 非常 详细 的 讲解 。 


4.5.1 ListView 的 简单 用 法 


首先 新 建 一 个 ListViewTest 项 目 ， 并 让 Android Studio 自 动 帮 有 我 们 创建 好 Activity。 然 后 修改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent"> 


<ListView 
android:id="@+id/listView" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</LinearLayout> 


在 布局 中 加 入 ListView 控 件 还 算 非 常 简单 ， 先 为 ListView 指 定 一 个 id ,然后 将 宽度 和 高 度 都 设 
置 为 natch_parent， 这样 ListView 就 占 满 了 整个 布局 的 空间 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


private val data = list0f("Apple", "Banana", "Orange", "Watermelon", 
"Pear", "Grape", "Pineapple", "Strawberry", "Cherry", "Mango", 
"Apple", "Banana", "Orange", "Watermelon", "Pear", "Grape", 


"Pineapple", "Strawberry", "Cherry", "Mango") 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val adapter = ArrayAdapter<String>(this,android.R.Tlayout.simple list item 1,data) 
listView.adapter = adapter 


} 


既然 ListView 是 用 于 展示 大 量 数 据 的 ， 那 我 们 就 应 该 先 将 数据 提供 好 。 这 些 数 据 可 以 从 网 上 下 
载 ， 也 可 以 从 数据 库 中 读 取 ， 应 该 视 具 体 的 应 用 程序 场景 而 定 。 这 里 我 们 就 简单 使 用 一 个 data 
集合 来 进行 测试 ， 里 面包 含 了 很 多 水 果 的 名 称 ， 初 始 化 集合 的 方式 使 用 的 是 之 前 在 第 2 章 学 过 的 
Listof () 上 级 数 。 


www.blogss.cn 


不 过 ,集合 中 的 数据 是 无 法 直接 传递 给 ListView 的 ， 我 们 还 需要 借助 适 配 缆 来 完成 。Android 
中 提供 了 很 多 适配器 的 实现 类 ， 其 中 我 认为 最 好 用 的 就 是 ArrayAdapter。 它 可 以 通过 泛 型 来 指 
定 要 适 配 的 数据 类 型 ， 然 后 在 构造 函数 中 把 要 适 配 的 数据 传 入 。ArrayAdapter 有 多 个 构造 水 数 
的 重 载 ， 你 应 该 根据 实际 情况 选择 最 合适 的 一 种 。 由 于 我 们 这 里 提供 的 数据 都 是 字符 串 ， 因 此 
将 ArrayAdapter 的 泛 型 指定 为 String， 然后 在 ArrayAdapter 的 构造 水 数 中 依次 传 入 Activity 
的 实例 、ListView 子 项 布局 的 id， 以 及 数据 源 。 注 意 ， 我们 使 用 了 
android.R.layout.simple list item 1 作为 ListView 子 项 布局 的 id ， 这 是 一 个 
Android 内 置 的 布局 文件 ， 里面 只 有 一 个 TextView ,可 用 于 简单 地 显示 一 段 文本 。 这 样 适 配 闫 
对 象 就 构建 好 了 。 


最 后 , 还 需要 调用 ListView 的 setAdapter() 方 法 ,将 构建 好 的 适配器 对 象 传递 进去 ， 这 样 
ListView 和 数据 之 间 的 关联 就 建立 完成 了 。 


现在 运行 一 下 程序 ， 效果 如 图 4.28 所 示 。 可 以 通过 滚动 的 方式 查看 屏幕 外 的 数据 。 
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图 4.28 ” ”ListView 运行 效果 
4.5.2 定制 ListView 的 界面 


只 能 显示 一 段 文本 的 ListView 实 在 是 太 单调 了 ， 我 们 现在 就 来 对 ListView 的 界面 进行 定制 ， 让 
它 可 以 显示 更 加 丰富 的 内 容 。 


首先 需要 准备 好 一 组 图 片 资源 (资源 下 载 地 址 见 前 言 ) ， 分 别 对 应 上 面 提供 的 每 一 种 水 果 , 待 
会 我 们 要 让 这 此 水 果 名 称 的 芝 > 张 相应 的 图 片 。 


接着 定义 一 个 实体 类 ， 作 为 ListView 适 配器 的 适 配 类 型 。 新 建 Fruit 类 ， 代 码 如 下 所 示 : 


class Fruit(val name:String, val imageId: Int) 
Fruit 类 中 只 有 两 个 字段 : name 表 示 水 果 的 名 字 ，imageId 表 示 水 果 对 应 图 片 的 资源 id。 


然后 需要 为 ListView 的 子 项 指定 一 个 我 们 自 定义 的 布局 , 在 layout 目 录 下 新 建 
fruit_ item.xml , 代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="60dp"> 


<ImageView 
android:id="@+id/fruitImage" 
android:layout width="40dp" 
android:layout height="40dp" 
android:layout gravity="center vertical" 
android:layout marginLeft="10dp"/> 


<TextView 
android:id="@+id/fruitName" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:layout marginLeft="10dp" /> 


</LinearLayout> 


在 这 个 布局 中 ,我们 定义 了 一 个 ImageView 用 于 显示 水 果 的 图 片 ， 又 定义 了 一 个 TextView 用 于 
显示 水 果 的 名 称 ,并 让 ImageView 和 TextView 都 在 垂直 方向 上 居中 显示 。 


接 下 来 需要 创建 一 个 自 定义 的 适配器 ， 这 个 适 配 郑 继承 自 ArrayAdapter， 并 将 泛 型 指定 为 
Fruit 类 。 新 建 类 FruitAdapter , 代码 如 下 所 示 : 


class FruitAdapter(activity: Activity, val resourceId: Int, data: List<Fruit>) : 
ArrayAdapter<Fruit>(activity, resourcelId, data) { 


override fun getView(position: Int, convertView: View?, parent: ViewGroup): View { 
val view = LayoutInflater.from(context).inflate(resourceIld, parent, false) 
val fruitImage: ImageView = view.findViewById(R.id.fruitIimage) 
val fruitName: TextView = view.findViewById(R.id.fruitName) 
val fruit = getItem(position) // 获取 当前 项 的 Fruit 实 例 
if (fruit != null) { 
fruitImage.SsetImageResource(fruit ,imageId) 
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fruitName .text = fruit.name 


return View 


} 


FruitAdapter 定 义 了 一 个 主 构造 函数 ， 用 于 将 Activity 的 实例 、ListView 子 项 布局 的 id 和 数 
据 源 传递 进来 。 另 外 又 重 写 了 getView() 方 法 ,这 个 方法 在 每 个 子 项 被 滚动 到 屏幕 内 的 时 候 会 
被 调用 。 


在 getView( ) 方 法 中 ,首先 使 用 LayoutInfLater 来 为 这 个 子 项 加 载 我 们 传 入 的 布局 。 
LayoutInfLater 的 infLate() 方 法 接收 3 个 参数 ， 前 两 个 参数 我 们 已 经 知道 是 什么 意思 了 ， 
第 三 个 参数 指定 成 faLse， 表示 只 让 我 们 在 父 布局 中 声明 的 Layout 属 性 生效 ， 但 不 会 为 这 个 
View 添 加 父 布局 。 因 为 一 旦 View 有 了 父 布局 之 后 ， 它 就 不 能 再 添加 到 ListView 中 了 。 如 果 你 现 
在 还 不 能 理解 这 段 话 的 含义 ， 也 没关系 ， 只 需要 知道 这 是 ListView 中 的 标准 写法 就 可 以 了 ， 当 
你 以 后 对 View 理 解 得 更 加 深刻 的 时 候 ， 再 来 读 这 段 话 就 没有 问题 了 。 


我 们 继续 往 下 看 ， 接 下 来 调用 View 的 findViewById ( ) 方 法 分 别 获取 到 ImageView 和 
TextView 的 实例 ， 然后 通过 getItem ( ) 方 法 得 到 当前 项 的 Fruit 实 例 ， 并 分 别 调用 它们 的 
setImageResource() 和 setText( ) 方 法 设置 显示 的 图 片 和 文字 ， 最 后 将 布局 返回 ， 这 样 我 
们 自 定义 的 适配器 就 完成 了 。 


需要 注意 的 是 ，kotlin-android-extensions 插 件 在 ListView 的 适配器 中 也 能 正常 工作 ,将 上 述 
代码 中 的 两 处 findViewById ( ) 方 法 分 别 替换 成 view.fruitImage 和 view.fruitName , 效 
果 是 一 模 一 样 的 ， 你 可 以 自己 动手 尝试 一 下 。 


最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val fruitList = ArrayList<Fruit>() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initFruits() // 初始 化 水 果 数 据 
val adapter = FruitAdapter(this, R.layout.fruit item, fruitList) 
listView.adapter = adapter 


} 


private fun initFruits() { 
repeat(2) { 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 


Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 


Apple", R.drawable.apple pic)) 

Banana", R.drawable.banana pic)) 
Orange", R.drawable.orange pic)) 
Watermelon", R.drawable.watermelon pic)) 
Pear", R.drawable.pear pic)) 

Grape", R.drawable.grape pic)) 
Pineapple", R.drawable.pineapple pic)) 
Strawberry", R.drawable.strawberry pic)) 
Cherry", R.drawable.cherry pic)) 

Mango", R.drawable.mango pic)) 


一 一 一 一 一 一 一 一 一 一 


(二 
(" 
(" 
(" 
全 
(" 
(" 
(A 
(™ 
(" 
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} 


可 以 看 到 ， 这 里 添加 了 一 个 jnitFruits() 方 法 ,用 于 初始 化 所 有 的 水 果 数 据 。 在 Fruit 类 的 
构造 水 数 中 将 水 果 的 名 字 和 对 应 的 图 片 id 传 入 ， 然 后 把 创建 好 的 对 象 添加 到 水 果 列 表 中 。 男 外 ， 
我 们 使 用 了 一 个 repeat 函 数 将 所 有 的 水 果 数 据 添加 了 两 遍 ， 这 是 因为 如 果 只 添加 一 遍 的 话 ， 数 
据 量 还 不 足以 充满 整个 屏幕 。repeat 函 数 是 Kotlin 中 另外 一 个 非常 常用 的 标准 函数 ， 它 允许 你 
传 入 一 个 数值 7， 然后 会 把 Lambda 表 达 式 中 的 内 容 执行 7 遍 。 接 着 在 onCreate ( ) 方 法 中 创建 
了 FruitAdapter 对 象 ， 并 将 它 作为 适配器 传递 给 ListView， 这样 定 制 ListView 界 面 的 任务 就 
完成 了 。 


现在 重新 运行 程序 ,效果 如 图 4.29 所 示 。 
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虽然 目前 我 们 定制 的 界面 还 很 简单 ， 但 是 相信 你 已 经 领悟 到 了 记 宿 ,只 要 修改 fruit_item.xml 
中 的 内 容 ， 就 可 以 定制 出 各 种 复杂 的 界面 了 。 


4.5.3 提升 ListView 的 运行 效率 


之 所 以 说 ListView 这 个 控件 很 难 用 ， 是 因为 它 有 很 多 细节 可 以 优化 ， 其 中 运行 效率 就 是 很 重要 
的 一 点 。 目 前 我 们 ListView 的 运行 效率 是 很 低 的 ， 因 为 在 FruitAdapter 的 getView( ) 方 法 
中 ,每 次 都 将 布局 重新 加 载 了 一 遍 ， 当 ListView 快 速 滚动 的 时 候 ， 这 就 会 成 为 性 能 的 瓶颈 。 


仔细 观察 你 会 发 现 ，getView( ) 方 法 中 还 有 一 个 convertView 参 数 ， 这 个 参数 用 于 将 之 前 加 
载 好 的 布局 进行 缓存 ， 以 便 之 后 进行 重用 ， 我 们 可 以 借助 这 个 参数 来 进行 性 能 优化 。 修 改 
FruitAdapter 中 的 代码 ,如 下 所 示 : 


class FruitAdapter(activity: Activity, val resourceId: Int, data: List<Fruit>) : 
ArrayAdapter<Fruit>(activity, resourcelId, data) { 


override fun getView(position: Int, convertView: View?, parent: ViewGroup): View { 
val view: View 


if (convertView == null) { 
view = LayoutInflater.from(context).inflate(resourcelId, parent, false) 
} else { 


view = convertView 
} 
val fruitImage: ImageView = view.findViewById(R.id.fruitIimage) 
val fruitName: TextView = view.findViewById(R.id.fruitName) 
val fruit = getItem(position) // 获取 当前 项 的 Fruit 实 例 
if (fruit != nuLL) { 
fruitImage.SsetImageResource(fruit ,imageId) 
fruitName .text = fruit.name 
} 


return view 


} 


可 以 看 到 ， 现在 我 们 在 getView( ) 方 法 中 进行 了 判断 : 如 果 convertView 为 nuLL， 则 使 用 
LayoutInflater 去 加 载 布局 ; 如 果 不 为 nuLL， 则 直接 对 convertView 进 行 重用 。 这 样 就 大 
大 提高 了 ListView 的 运行 效率 ， 在 快速 滚动 的 时 候 可 以 表现 出 更 好 的 性 能 。 


不 过 ,目前 我 们 的 这 份 代码 还 是 可 以 继续 优化 的 ， 虽 然 现 在 已 经 不 会 再 重复 去 加 载 布 局 , 但 是 
每 次 在 getView( ) 方 法 中 仍然 会 调用 View 的 findViewById ( ) 方 法 来 获取 一 次 控件 的 实例 。 
我 们 可 以 借助 一 个 ViewHolder 来 对 这 部 分 性 能 进行 优化 ,修改 FruitAdapter 中 的 代码 ,如 
下 所 示 : 


class FruitAdapter(activity: Activity, val resourceId: Int, data: List<Fruit>) : 
ArrayAdapter<Fruit>(activity, resourcelId, data) { 


inner class ViewHolder(val fruitImage: ImageView, val fruitName: TextView) 


override fun getView(position: Int, convertView: View?, parent: ViewGroup): View { 
val view: View 
val viewHolder: ViewHolder 
if (convertView == null) { 
view = LayoutInflater.from(context).inflate(resourcelId, parent, false) 
val fruitImage: ImageView = view.findViewById(R.id.fruitIimage) 
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val fruitName: TextView = view.findViewById(R.id.fruitName) 
viewHolder = ViewHolder(fruitImage, fruitName) 
view.tag = viewHolder 
} else { 
view = convertView 
viewHolder = View.tag as ViewHolder 


} 


val fruit = getItem(position) // 获取 当前 项 的 Fruit 实 例 

if (fruit != null) { 
viewHolder.fruitImage.setImageResource(fruit.imageld) 
viewHolder.fruitName.text = fruit.name 


} 


return view 


} 


我 们 新 增 了 一 个 内 部 类 ViewHolder ,用 于 对 ImageView 和 TextView 的 控件 实例 进行 缓存 ， 
Kotlin 中 使 用 inner class 关 键 字 来 定义 内 部 类 。 当 convertView 为 nutll 的 时 候 ，, 创建 一 个 
ViewHotLder 对 象 ， 并 将 控件 的 实例 存放 在 ViewHoLder 里 ,然后 调用 View 的 setTag ( ) 方 
法 ,将 ViewHoLder 对 象 存储 在 View 中 。 当 convertView 不 为 nuLL 的 时 候 ， 则 调用 View 的 
getTag ( ) 方 法 ,把 ViewHoLder 重 新 取出 。 这 样 所 有 控件 的 实例 都 缓存 在 了 ViewHotLder 里 ， 
就 没有 必要 每 次 都 通过 findViewById ( ) 方 法 来 获取 控件 实例 了 。 


通过 这 两 步 优化 之 后 ， 我 们 ListView 的 运行 效率 就 已 经 非常 不 错 了 。 

4.5.4 _ ListView 的 点 击 事件 

话说 回来 ，ListView 的 滚动 毕竟 只 是 满足 了 我 们 视觉 上 的 效果 ， 可 是 如 果 ListView 中 的 子 项 不 
能 点 击 的 话 ， 这 个 控件 就 没有 什么 实际 的 用 途 了 。 因 此 ， 本 小 节 我 们 就 来 学 习 一 下 ListView 如 
何 才能 响应 用 户 的 点 击 事件 。 

修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val fruitList = ArrayList<Fruit>() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initFruits() // 初始 化 水 果 数 据 
val adapter = FruitAdapter(this, R.layout.fruit item, fruitList) 
listView.adapter = adapter 
listView.setOnItemClickListener { parent, view, position, id -> 
val fruit = fruitList[position] 
Toast.makeText(this, fruit.name, Toast.LENGTH SHORT) .show() 
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可 以 看 到 ， 我 们 使 用 set0nItemCLickListener() 方 法 为 ListView 注 册 了 一 个 监听 器 ， 当 用 
户 点 击 了 ListView 中 的 任何 一 个 子 项 时 ， 就 会 回调 到 Lambda 表 达 式 中 。 这 里 我 们 可 以 通过 
position 参 数 判 断 用 户 点 击 的 是 哪 一 个 子 项 ， 然 后 获取 到 相应 的 水 果 ， 并 通过 Toast 将 水 果 的 
名 字 显 示 出 来 。 


重新 运行 程序 , 并 点 击 一 下 橘子， 效果 如 图 4.30 所 示 。 
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图 4.30 点击 ListView 的 效果 


上 述 代码 的 Lambda 表 达 式 在 参数 列表 中 声明 了 4 个 参数 ， 那 么 我 们 如 何 知道 需要 声明 哪儿 个 参 
数 呢 ? 这 里 我 来 教 你 一 个 办 法 ， 按 住 Ctrl 键 (Mac 系统 是 command 键 ) 点 击 
set0OnItemClickListener() 方 法 查看 它 的 源码 ,你 会 发 现 set0nItemClickListener() 
方法 接收 一 个 0nItemClickListener 参 数 ， 这 当然 就 是 一 个 Java 单 抽象 方法 接口 了 ， 要 不 然 
这 里 我 们 也 无 法 使 用 函数 式 API 的 写法 。0nItemCLickListener 接 口 的 定义 如 图 4.31 所 示 。 
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/ 半 沙 

* Interface definition for a callback to be invoked when an item in this 
* AdapterView has been clicked., 

*/ 

public interface OnItemClickListener { 


/ 


x 


Callback method to be invoked when an item in this AdapterView has 
been clicked. 

<p> 

Implementers can call getItemAtPosition(position) if they need 

to access the data associated with the selected item， 


区 


Gparam parent The AdapterView where the click happened. 

* @param view The view within the AdapterView that was clicked (this 

水 will be a view provided by the adapter) 

* @param position The position of the view in the adapter， 

* @param id The row id of the item that was clicked., 

*/ 

void onItemClick(AdapterView<?> parent, View view, int position, long id); 


图 4.31 0nItemClickListener 接 口 的 定义 


可 以 看 到 ，, 它 的 唯一 待 实现 方法 onItemClick() 中 接收 4 个 参数 ， 这些 就 是 我 们 要 在 Lambda 
表达 式 的 参数 列表 中 声明 的 参数 了 。 


另外 你 会 发 现 ， 虽 然 这 里 我 们 必须 在 Lambda 表 达 式 中 声明 4 个 参数 ， 但 实际 上 却 只 用 到 了 
position 这 一 个 参数 而 已 。 针 对 这 种 情况 ，Kotlin 允 许 我 们 将 没有 用 到 的 参数 使 用 下 划 线 来 蔡 
代 ， 因 此 下 面 这 种 写法 也 是 合法 且 更 加 推荐 的 : 


listView.setOnItemClickListener { ， , position, -> 
val fruit = fruitList[position] 
Toast.makeText(this, fruit.name, Toast.LENGTH SHORT).show!() 


注意 ， 即 使 将 没有 用 到 的 参数 使 用 下 划 线 来 代替 ， 它 们 之 间 的 位 置 是 不 能 改变 的 ，position 参 
数 仍然 得 在 第 三 个 参数 的 位 置 。 
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4.6 更 强大 的 滚动 控件 : RecyclerView 


ListView 由 于 强大 的 功能 ， 在 过 去 的 Android 开 发 当中 可 以 说 是 贡献 卓越 ， 直 到 今天 仍然 还 有 
不 计 其 数 的 程序 在 使 用 ListView。 不 过 ListView 并 不 是 完美 无 缺 的 ， 比 如 如 果 不 使 用 一 些 技巧 
来 提升 它 的 运行 效率 ， 那 么 ListView 的 性 能 就 会 非常 差 。 还 有 ,ListView 的 扩展 性 也 不 够 好 ， 
它 只 能 实现 数据 纵向 滚动 的 效果 ， 如 果 我 们 想 实 现 横向 滚动 的 话 ，ListView 是 做 不 到 的 。 

为 此 , Android 提供 了 一 个 更 强大 的 滚动 控件 一 一 RecyclerView。 它 可 以 说 是 一 个 增强 版 的 
ListView , 不 仅 可 以 轻松 实现 和 ListView 同 样 的 效果 ， 还 优化 了 ListView 存 在 的 各 种 不 足 之 
处 。 目 前 Android 官 方 更 加 推荐 使 用 RecyclerView ,未 来 也 会 有 更 多 的 程序 逐渐 从 ListView 转 
向 RecyclerView ,那么 本 节 我 们 就 来 详细 讲解 一 下 RecyclerView 的 用 法 。 


首先 新 建 一 个 RecyclerViewTest 项 目 ， 并 让 Android Studio 自 动 帮 有 我 们 创建 好 Activity。 
4.6.1 RecyclerView 的 基本 用 法 

和 之 前 我 们 所 学 的 所 有 控件 不 同 ，RecyclerView 属 于 新 增 控件 ， 那么 怎样 才能 让 新 增 的 控件 在 
所 有 Android 系 统 版 本 上 都 能 使 用 呢 ? 为 此 ,Google 将 RecyclerView 控 件 定义 在 了 AndroidX 


当中 ， 我 们 只 需要 在 项 目的 build.gradle 中 添加 RecyclerView 库 的 依赖 ， 就 能 保证 在 所 有 
Android 系 统 版 本 上 都 可 以 使 用 RecyclerView 控 件 了 。 


打开 app/build.gradle 文 件 , 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation"org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 
implementation 'androidx.appcompat:appcompat:1.0.2" 
implementation "androidx.core:core-ktx:1.0.2， 
implementation 'androidx.constraintlayout:constraintlayout:1.1.3" 
implementation 'androidx.recyclerview:recyclerview:1.0.0' 
testImpLementation ‘junit:junit:4.12'" 
androidTestImpLementation 'androidx.test:runner:1.1.1' 
androidTestImpLementation 'androidx.test.espresso:espresso-core:3.1.1' 


} 


上 述 代码 就 表示 将 RecyclerView 库 引入 我 们 的 项 目 当 中 ， 其 中 除了 版 本 号 部 分 可 能 会 变化 ,其 
他 部 分 是 固定 不 变 的 。 那 么 可 能 你 会 好 奇 ， 我 怎么 知道 每 个 库 现在 最 新 的 版 本 号 是 多 少 呢 ? 这 

告诉 你 一 个 小 穿 门 ， 当 你 不 能 确定 最 新 的 版 本 号 是 多 少 的 时 候 ,可 以 就 像 上 述 代码 一 样 填 入 
1.0.0， 当 有 更 新 的 库 版 本 时 ，Android Studio 会 主动 提醒 你 ， 并 告诉 你 最 新 的 版 本 号 是 多 少 ， 
如 图 4.32 所 示 。 


implementation "androidx.appcompat:appcompat:1.0.0' 


A newer version of androidx.appcompat:appcompat than 1.0.0 is available: 1.0.2 more... ( 蜡 F1) 


图 4.32 Android Studio 提 醒 有 库 版 本 更 新 
另外 , 每 当 修改 了 任何 gradle 文 件 , Android Studio 都 弹出 一 个 如 图 4.33 所 示 的 提示 。 
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Gradle files have changed since last project sync. A project sync may be necessary for the IDE to work properly， Sync Now 


图 4.33 gradle 文 件 修改 后 的 提示 

这 个 提示 告诉 我 们 ， gradle 文 件 自 上 次 同步 之 后 又 发 生 了 变化 ,需要 再 次 同步 才能 使 项 目 正 常 
工作 。 这 里 只 需要 点 击 “Sync Now" 就 可 以 了 ， 然后 gradle 会 开始 进行 同步 ， 把 我 们 新 添加 的 
RecyclerView 库 引入 项 目 当中 。 


接 下 来 修改 activity_main.xml 中 的 代码 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent"> 


<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</LinearLayout> 


在 布局 中 加 入 RecyclerView 扫 空 件 也 是 非 党 简单 的 ， 先 为 RecyclerView 指 定 一 个 jd， 然后 将 宽 
、 和 高 度 都 设置 为 natch_parent , 这 样 RecyclerView 就 占 满 了 整个 布局 的 空间 。 需 要 注意 的 
, 由 于 RecyclerView 并 不 是 内 置 在 系统 SDK 当 中 的 ， 所 以 需要 把 完整 的 包 路 径 写 出 来 。 


这 里 我 们 想 要 使 用 RecyclerView 来 实现 和 ListView 相 同 的 效果 ， 因 此 就 需要 准备 一 份 同样 的 水 
果 图 片 。 简 单 起 见 ， 我 们 就 直接 从 ListViewTest 项 目 中 把 图 片 复制 过 来 ， 另 外 顺便 将 Fruit 类 
和 fruit_item.xml 也 复制 过 来 ， 省 得 将 同样 的 代码 再 写 一 遍 。 


接 下 来 需要 为 RecyclerView 准 备 一 个 适配器 ， 新 建 FruitAdapter 类 ,让 这 个 适配器 继承 自 
RecyclerView.Adapter , 并 将 泛 型 指定 为 FruitAdapter.ViewHoLder。 其 中 ， 
ViewHolder 是 我 们 在 FruitAdapter 中 定义 的 一 个 内 部 类 ， 代码 如 下 所 示 : 


class FruitAdapter(val fruitList: List<Fruit>) : 
RecyclerView.Adapter<FruitAdapter.ViewHolder>() { 


inner class ViewHolder(view: View) : RecyclerView.ViewHolder(view) { 
val fruitImage: ImageView = view.findViewById(R.id.fruitIimage) 
val fruitName: TextView = view.findViewById(R.id.fruitName) 


} 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context) 
.infLate(R,Layout.fruit item, parent, false) 
return ViewHolder (view) 


} 


override fun onBindViewHolder(holder: ViewHolder, position: Int) { 
val fruit = fruitList[position] 
hoLder.fruitImage,SsetImageResource(fruit, imageId ) 
hoLder.fruitName .text = fruit.name 


} 


override fun getItemCount() = fruitList.size 
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这 是 RecyclerView 适 配器 标准 的 写法 ， 虽 然 看 上 去 好 像 多 了 好 几 个 方法 ,但 其 实 它 比 ListView 
的 适配器 要 更 容易 理解 。 这 里 我 们 首先 定义 了 一 个 内 部 类 ViewHolder , 它 要 继承 自 
RecyclerView.ViewHolder。 然 后 ViewHolder 的 主 构造 函数 中 要 传 入 一 个 View 参 数 ， 这 
个 参数 通常 就 是 RecyclerView 子 项 的 最 外 层 布 局 ,那么 我 们 就 可 以 通过 findViewById ( ) 方 
法 来 获取 布局 中 ImageView 和 TextView 的 实例 了 。 


FruitAdapter 中 也 有 一 个 主 构造 永 数 ， 它 用 于 把 要 展示 的 数据 源 传 进来 ， 我 们 后 续 的 操作 都 
将 在 这 个 数据 源 的 基础 上 进行 。 


继续 往 下 看 ， 由 于 FruitAdapter 是 继承 自 RecyclerView.Adapter 的 ， 那 么 就 必须 重 写 
onCreateViewHolder()、onBindViewHolder() 和 getItemCount() 这 3 个 方法 。 
onCreateViewHolder() 方 法 是 用 于 创建 ViewHolder 实 例 的 ， 我 们 在 这 个 方法 中 将 

fruit item 布 局 加 载 进来 ， 然后 创建 一 个 ViewHolder 实 例 ， 并 把 加 载 出 来 的 布局 传 入 构造 
孔 数 当中 ， 最 后 将 ViewHolder 的 实例 返回 。onBindViewHolder() 方 法 用 于 对 
RecyclerView 子 项 的 数据 进行 赋值 ， 会 在 每 个 子 项 被 滚动 到 屏幕 内 的 时 候 执行 ， 这 里 我 们 通过 
position 参 数 得 到 当前 项 的 Fruit 实 例 ， 然 后 再 将 数据 设置 到 ViewHoLder 的 ImageView 和 
TextView 当 中 即 可 。getItemCount ( ) 方 法 就 非常 简单 了 ，, 它 用 于 告诉 RecyclerView 一 共有 
多 少子 项 ,直接 返回 数据 源 的 长 度 就 可 以 了 。 


适配器 准备 好 了 之 后 ,我 们 就 可 以 开始 使 用 RecyclerView 了 ， 修 改 MainActivity 中 的 代码 , 如 
下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val fruitList = ArrayList<Fruit>() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initFruits() // 初始 化 水 果 数 据 
val layoutManager = LinearLayoutManager(this) 
recyclerView.layoutManager = layoutManager 
val adapter = FruitAdapter(fruitList) 
recyclerView.adapter = adapter 


} 


private fun initFruits() { 
repeat(2) { 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 
fruitList.add 


Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 
Fruit 


Apple", R.drawable.apple pic)) 

Banana", R.drawable.banana pic)) 
Orange", R.drawable.orange pic)) 
Watermelon", R.drawable.watermelon pic)) 
Pear", R.drawable.pear pic)) 

Grape", R.drawable.grape pic)) 
Pineapple", R.drawable.pineapple pic)) 
Strawberry", R.drawable.strawberry pic)) 
Cherry", R.drawable.cherry pic)) 

Mango", R.drawable.mango pic)) 


一 一 一 一 一 一 一 一 一 一 


便 
(二 
(" 
(" 
(" 
(a 
(" 
( 
(" 
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可 以 看 到 ， 这 里 使 用 了 一 个 同样 的 initFruits() 方 法 ,用 于 初始 化 所 有 的 水 果 数 据 。 接 着 在 
onCreate( ) 方 法 中 先 创 建 了 一 个 LinearLayoutManager 对 象 ， 并 将 它 设 置 到 
RecyclerView 当 中 。LayoutManager 用 于 指定 RecyclerView 的 布局 方式 , 这 里 使 用 的 
LinearLayoutManager 是 线性 布局 的 意思 ， 可 以 实现 和 ListView 类 似 的 效果 。 接 下 来 我 们 创 
建 了 FruitAdapter 的 实例 ,并 将 水 果 数 据 传 入 FruitAdapter 的 构造 函数 中 ， 最 后 调用 
RecyclerView 的 setAdapter() 方 法 来 完成 适配器 设置 ,这样 RecyclerView 和 数据 之 间 的 关 
联 就 建立 完成 了 。 


现在 运行 一 下 程序 ， 效 果 如 图 4.34 所 示 。 
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图 4.34 RecyclerView 运 行 效果 
可 以 看 到 ,我们 使 用 RecyclerView 实 现 了 和 ListView 几 乎 一 模 一 样 的 效果 ,虽说 在 代码 量 方面 


并 没有 明显 的 减少 ,但 是 逻辑 变 得 更 加 清晰 了 。 当 然 这 只 是 RecyclerView 的 基本 用 法 而 已 ， 接 
下 来 我 们 就 看 一 看 RecyclerView 还 能 实现 哪些 ListView 实 现 不 了 的 效果 。 
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4.6.2 ”实现 横向 滚动 和 瀑布 流 布 局 


我 们 已 经 知道 ，ListView 的 扩展 性 并 不 好 ，, 它 只 能 实现 纵向 滚动 的 效果 ， 如果 想 进行 横向 滚动 
的 话 ，ListView 就 做 不 到 了 。 那 么 RecyclerView 就 能 做 得 到 吗 ? 当然 可 以 ， 不仅 能 做 得 到 ,还 
非常 简单 。 接 下 来 我 们 就 尝试 实现 一 下 横向 滚动 的 效果 。 


首先 要 对 fruit item 布 局 进行 修改 ， 因 为 目前 这 个 布局 里 面 的 元 素 是 水 平 排列 的 ， 适 用 于 纵 
向 滚动 的 场景 ， 而 如 果 我 们 要 实现 横向 滚动 的 话 ， 应 该 把 fruit_item 里 的 元 素 改 成 垂直 排列 
才 比 较 合 理 。 修 改 fruit_item.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="80dp" 
android:layout height="wrap content"> 


<ImageView 
android:id="@+id/fruitImage" 
android:layout width="40dp" 
android:layout height="40dp" 
android:layout gravity="center horizontal" 
android:layout marginTop="10dp" /> 


<TextView 
android:id="@+id/fruitName" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:layout marginTop="10dp" /> 


</LinearLayout> 


可 以 看 到 ， 我 们 将 LinearLayout 改 成 垂直 方向 排列 ， 并 把 亮度 设 为 80 dp。 这 里 将 宽度 指定 为 
固定 值 是 因为 每 种 水 果 的 文字 长 度 不 一 致 ， 如果 用 wrap_content 的 话 ，RecyclerView 的 子 项 
就 会 有 长 有 短 ， 非 常 不 美观 ， 而 如 果 用 match_parent 的 话 ， 就 会 导致 宽度 过 长 ， 一 个 子 项 占 
满 整 个 屏幕 。 


然后 我 们 将 ImageView 和 TextView 都 设置 成 了 在 布局 中 水 平 居中 ， 并 且 使 用 
layout_marginTop 属 性 让 文字 和 图 片 之 间 保 持 一 定 距 离 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val fruitList = ArrayList<Fruit>() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initFruits() // 初始 化 水 果 数 据 
val layoutManager = LinearLayoutManager(this) 
layoutManager.orientation = LinearLayoutManager .HORIZONTAL 
recyclerView.layoutManager = layoutManager 
val adapter = FruitAdapter(fruitList) 
recyclerView.adapter = adapter 
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} 


MainActivity 中 只 加 入 了 一 行 代码 ,调用 LinearLayoutManager 的 set0rientation() 方 法 
设置 布局 的 排列 方向 。 默 认 是 纵向 排列 的 ， 我 们 传 入 LinearLayoutManager.HORIZONTAL 
表示 让 布局 横行 排列 ,这样 RecyclerView 就 可 以 横向 滚动 了 。 


重新 运行 一 下 程序 ,效果 如 图 4.35 所 示 。 


10:36 


RecyclerViewTest 


@ tO ©. 和 


Apple Banana Orange Watermelon Pear 


图 4.35 横向 RecyclerView 效 果 
你 可 以 用 手指 在 水 平方 向 上 滑动 来 查看 屏幕 外 的 数据 。 


为 什么 ListView 很 难 或 者 根本 无 法 实现 的 效果 在 RecyclerView 上 这 人 么 轻松 就 实现 了 呢 ? 这 主要 
得 益 于 RecyclerView 出 色 的 设计 。ListView 的 布局 排列 是 由 自身 去 管理 的 ， 而 RecyclerView 
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则 将 这 个 工作 交 给 了 LayoutManager。LayoutManager 制 定 了 一 套 可 扩展 的 布局 排列 接口 ， 
子 类 只 要 按照 接口 的 规范 来 实现 ， 就 能 定制 出 各 种 不 同 排列 方式 的 布局 了 。 


除了 LinearLayoutManager 之 外 ，RecyclerView 还 给 我 们 提供 了 GridLayoutManager 和 
StaggeredGridLayoutManager 这 两 种 内 置 的 布局 排列 方式 。GridLayoutManager 可 以 用 于 
实现 网 格 布局 , StaggeredGridLayoutManager 可 以 用 于 实现 瀑布 流 布 局 。 这 里 我 们 来 实现 
一 下 效果 更 加 炫 酷 的 瀑布 流 布 局 ,网 格 布局 就 作为 课 后 习题 ， 交 给 你 自己 来 研究 了 。 


首先 还 是 来 修改 一 人 fruit_item.xml 中 的 代码 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="5dp"> 


<ImageView 
android:id="@+id/fruitImage" 
android:layout width="40dp" 
android:layout height="40dp" 
android:layout gravity="center horizontal" 
android:layout marginTop="10dp" /> 


<TextView 
android:id="@+id/fruitName" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="left" 
android:layout marginTop="10dp" /> 


</LinearLayout> 


这 里 做 了 几 处 小 的 调整 ， 首 先 将 LinearLayout 的 宽度 由 80 dp 改 成 了 match_parent ,因为 瀑 
布 流 布局 的 充 度 应 该 是 根据 布局 的 列 数 来 自动 适 配 的 ， 而 不 是 一 个 固定 值 。 其 次 我 们 使 用 了 
Layout_ margin 属性 来 让 子 项 之 间 互 留 一 点 间距 ,这样 就 不 至 于 所 有 子 项 都 紧 贴 在 一 些 。 最 后 
还 将 TextView 的 对 齐 属性 改 成 了 居 左 对 齐 ， 因 为 待 会 我 们 会 将 文字 的 长 度 变 长 ， 如 果 还 是 居中 
显示 就 会 感觉 怪 怪 的 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val fruitList = ArrayList<Fruit>() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initFruits() // 初始 化 水 果 数 据 
val layoutManager = StaggeredGridLayoutManager(3, 
StaggeredGridLayoutManager .VERTICAL) 
recyclerView.layoutManager = layoutManager 
val adapter = FruitAdapter(fruitList) 
recyclerView.adapter = adapter 


} 


private fun initFruits() { 
repeat(2) { 
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fruitList.add(Fruit(getRandomLengthString("Apple"), 
R.drawable.apple pic)) 
fruitList.add(Fruit(getRandomLengthString("Banana"), 
R.drawable.banana pic)) 
fruitList.add(Fruit(getRandomLengthString("Orange"), 
R.drawable.orange pic)) 
fruitList.add(Fruit(getRandomLengthString("Watermelon"), 
R.drawable.watermelon pic)) 
fruitList.add(Fruit(getRandomLengthString("Pear"), 
R.drawable.pear pic)) 
fruitList.add(Fruit(getRandomLengthString("Grape"), 
R.drawable.grape pic)) 
fruitList.add(Fruit(getRandomLengthString("Pineapple"), 
R.drawable.pineapple pic)) 
fruitList.add(Fruit(getRandomLengthString("Strawberry"), 
R.drawable.strawberry pic)) 
fruitList.add(Fruit(getRandomLengthString("Cherry"), 
R.drawable.cherry pic)) 
fruitList.add(Fruit(getRandomLengthString("Mango"), 
R.drawable.mango pic)) 


} 


private fun getRandomLengthString(str: String): String { 
valL n = (1..20).random() 
val builder = StringBuilder() 
repeat(n) { 
builder.append(str) 
} 


return builder.toString() 


} 


首先 ,在 onCreate( ) 方 法 中 ,我 们 创建 了 一 个 StaggeredGridLayoutManager 的 实例 。 
StaggeredGridLayoutManager 的 构造 函数 接收 两 个 参数 : 第 一 个 参数 用 于 指定 布局 的 列 
数 ， 传 入 3 表示 会 把 布局 分 为 3 列 ; 第 二 个 参数 用 于 指定 布局 的 排列 方向 ， 传 入 
StaggeredGridLayoutManager.VERTICAL 表 示 会 让 布局 纵向 排列 。 最 后 把 创建 好 的 实例 
设置 到 RecyclerView 当 中 就 可 以 了 ， 就 是 这 么 简单 ! 


没 错 ， 仅仅 修 改 了 一 行 代 码 ，, 我们 就 已 经 成 功 实现 瀑 布 流 布局 的 效果 了 。 不 过 由 于 瀑布 流 布 局 
需要 各 个 子 项 的 高 度 不 一 致 才能 看 出 明显 的 效果 ， 为 此 我 又 使 用 了 一 个 小 技巧 。 这 里 我 们 把 眼 
光 聚 焦 到 getRandomLengthString() 这 个 方法 上 ，, 这 个 方法 中 调用 了 Range 对 象 的 
random( ) 浮 数 来 创造 一 个 1 到 20 之 间 的 随机 数 ， 然 后 将 参数 中 传 入 的 字符 串 随 机 重复 几 遍 。 在 
initFruits() 方 法 中 ,每 个 水 果 的 名 字 都 改 成 调用 getRandomLengthString () 这 个 方法 
来 生成 ， 这 样 就 能 保证 各 水 果 名 字 的 长 短 差 距 比 较 大 ， 子 项 的 高 度 也 就 各 不 相同 了 。 


现在 重新 运行 一 下 程序 ， 效果 如 图 4.36 所 示 。 
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RecyclerViewTest 


图 4.36 ”瀑布 流 布 局 效果 
当然 ， 由 于 水 果 名 字 的 长 度 每 次 都 是 随机 生成 的 ， 你 运行 时 的 效果 肯定 和 图 中 是 不 一 样 的 。 
4.6.3 ” RecyclerView 的 点 击 事件 


和 ListView 一 样 ，RecyclerView 也 必须 能 响应 点 击 事件 才 可 以 ， 不然 的 话 就 没什么 实际 用 途 
了 。 不 过 不 同 于 ListView 的 是 ,RecyclerView 并 没有 提供 类 似 于 
set0nItemClickListener() 这 样 的 注册 监听 器 方法 ,而 是 需要 我 们 自己 给 子 项 具体 的 View 
去 注册 点 击 事件 。 这 相 比 于 ListView 来 说 ,实现 起 来 要 复杂 一 些 。 


那么 你 可 能 就 有 疑问 了 ， 为 什么 RecyclerView 在 各 方面 的 设计 都 要 优 于 ListView， 偏偏 在 点 击 
事件 上 却 没有 处 理 得 非常 好 呢 ? 其 实 不 是 这 样 的 ,ListView 在 点 击 事件 上 的 处 理 并 不 人 性 化 ， 
setOnItemCLickListener() 方 法 注册 的 是 子 项 的 点 击 事件 ， 但 如 果 我 想 点 击 的 是 子 项 里 具 
体 的 某 一 个 按钮 呢 ? 虽然 ListView 也 能 做 到 ， 但 是 实现 起 来 就 相对 比较 麻烦 了 。 为 此 ， 
RecyclerView 干 脆 直 接 据 弃 了 子 项 点 击 事件 的 监听 器 ， 让 所 有 的 点 击 事件 都 由 具体 的 View 去 
注册 ， 就 再 没有 这 个 困扰 了 。 
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下 面 我 们 来 具体 学 习 一 下 如 何在 RecyclerView 中 注册 点 击 事件 ,修改 FruitAdapter 中 的 代 
码 ， 如 下 所 示 : 


class FruitAdapter(val fruitList: List<Fruit>) : 
RecyclerView.Adapter<FruitAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context) 
.infLate(R,Layout.fruit item, parent, false) 
val viewHolder = ViewHolder(view) 
viewHolder.itemView.setOnClickListener { 
val position = viewHolder.adapterPosition 
val fruit = fruitList[position] 
Toast.makeText(parent.context, "you clicked view ${fruit.name}", 
Toast .LENGTH SHORT).show() 
} 
viewHolder.fruitImage.setOnClickListener { 
val position = viewHolder.adapterPosition 
val fruit = fruitList[position] 
Toast.makeText(parent.context, "you clicked image ${fruit.name}", 
Toast .LENGTH SHORT).show() 
} 


return viewHolder 


} 


可 以 看 到 ， 这 里 我 们 是 在 onCreateViewHolder() 方 法 中 注册 点 击 事 件 。 上 述 代码 分 别 为 最 
外 层 布 局 和 lImageView 都 注册 了 点 击 事件 ,itemView 表 示 的 就 是 最 外 层 布 局 。RecyclerView 
的 强大 之 处 也 在 于 此 , 它 可 以 轻松 实现 子 项 中 任意 控件 或 布局 的 点 击 事件 。 我 们 在 两 个 点 击 事 
件 中 先 获 取 了 用 户 点 击 的 position ,然后 通过 position 拿 到 相应 的 Fruit 实 例 ， 再 使 用 Toast 分 
别 弹出 两 种 不 同 的 内 容 以 示 区 别 。 


现在 重新 运行 代码 ， 并 点 击 苹果 的 图 片 部 分 ， 效 果 如 图 4.37 所 示 。 可 以 看 到 ， 这 时 触发 了 
ImageView 的 点 击 事件 。 
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RecyclerViewTest 
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图 4.37 点击 苹果 的 图 片 部 分 


然后 点 击 橘子 的 文字 部 分 ， 由 于 TextView 并 没有 注册 点 击 事件 ， 因 此 点 击 文字 这 个 事件 会 被 子 
项 的 最 外 层 布 局 捕获 ， 效 果 如 图 4.38 所 示 。 
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图 4.38 
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4.7 编写 界面 的 最 佳 实践 

既然 已 经 学 习 了 那么 多 UI 开发 的 知识 ， 是 时 候 实战 一 下 了 。 这 次 我 们 要 综合 运用 前 面 所 学 的 大 
量 内 容 来 编写 出 一 个 较为 复杂 且 相 当 美 观 的 聊天 界面 ， 你 准备 好 了 吗 ? 要 先 创建 一 个 
UIBestPractice 项 目 才 算 准 备 好 了 哦 。 

4.7.1 制作 9-Patch 图 片 


在 实战 正式 开始 之 前 ， 我 们 需要 先 学 习 一 下 如 何 制 作 9-Patch 图 片 。 你 之 前 可 能 没有 听 说 过 这 个 
名 词 ， 它 是 一 种 被 特殊 处 理 过 的 png 图 片 ， 能 够 指定 哪些 区 域 可 以 被 拉 伸 、 哪 些 区 域 不 可 以 。 


那么 9-Patch 图 片 到 底 有 什么 实际 作用 呢 ? 我 们 还 是 通过 一 个 例子 来 看 一 下 吧 。 首 先 在 
UlBestPractice 项 目 中 放置 一 张 气泡 样式 的 图 片 message_left.png (资源 下 载 地 址 见 前 


言 ) ， 如 图 4.39 所 示 。 
图 4.39 气泡 样式 图 片 


我 们 将 这 张 图 片 设置 为 LinearLayout 的 月 景 图 片 , 修改 activity_main.xml 中 的 代码 ,如 下 所 
不 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="50dp" 
android:background="@drawable/message left"> 

</LinearLayout> 


这 里 将 LinearLayout 的 宽度 指定 为 natch_parent , 将 它 的 背景 图 设置 为 nessage left。 
现在 运行 程序 ,效果 如 图 4.40 所 示 。 
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UlBestPractice 


图 4.40 ”气泡 被 均匀 拉 伸 的 效果 


可 以 看 到 ,由 于 message Left 的 宽度 不 足以 填 满 整 个 屏幕 的 宽度 ， 整 张 图 片 被 均匀 地 拉 伸 
了 ! 这 种 效果 非常 差 ， 用 户 肯 定 是 不 能 容忍 的 ， 这 时 就 可 以 使 用 9-Patch 图 片 来 进行 改善 。 


制作 9-Patch 图 片 其 实 并 不 复杂 ， 只 要 掌握 好 规则 就 行 了 ， 那么 现在 我 们 就 来 学 习 一 下 。 


在 Android Studio 中 ,我 们 可 以 将 任何 png 类 型 的 图 片 制作 成 9-Patch 图 片 。 首 先 对 着 
message_left.png 图 片 右 击 ”>Create 9-Patch file， 会 弹出 如 图 4.41 所 示 的 对 话 框 。 


Save As: message_left.9.png Y 
Tags: 
Where: 国 drawable-xxhdpi 
Cancel Save 


图 4.41 创建 9-Patch 图 片 的 对 话 框 


这 里 保持 默认 文件 名 就 可 以 了 ， 其实 就 相当 于 创建 了 一 张 以 9.png 为 后 缀 的 同名 图 片 ,点 
击 “Save" 完 成 保存 。 这 时 Android Studio 会 显示 如 图 4.42 所 示 的 编辑 界面 。 


www.blogss.cn 


message left.9.png 


Press Control/Shift while dragging on the border to modify layout bounds. 
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图 4.42 9-Patch 图 片 的 编辑 界面 


我 们 可 以 在 图 片 的 4 个 边框 绘制 一 个 个 的 小 黑 点 ， 在 上 边框 和 左边 框 绘制 的 部 分 表示 当 图 片 需 
拉 伸 时 就 拉 伸 黑 点 标记 的 区 域 ， 在 下 边框 和 右边 框 绘制 的 部 分 表示 内 容 人 允许 被 放置 的 区 域 。 使 
用 鼠标 在 图 片 的 边缘 拖 动 就 可 以 进行 绘制 了 ， 按 住 Shif 键 拖 动 可 以 进行 擦 除 。 绘 制 完 成 后 效果 
如 图 4.43 所 示 。 
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图 4.43 绘制 完成 后 的 message_left 图 片 


最 后 记得 要 将 原来 的 message_left.png 图 片 删除 ， 只 保留 制作 好 的 message_left.9.png 图 片 
即 可 ,因为 Android 项 目 中 不 允许 同一 文件 夹 下 有 两 张 相 同名 称 的 图 片 (即使 后 缀 名 不 同 也 不 
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行 ) 。 重 新 运行 程序 ,效果 如 图 4.44 所 示 。 
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图 4.44 气泡 只 拉 伸 绘制 区 域 的 效果 


这 样 当 图 片 需要 拉 伸 的 时 候 ， 就 可 以 只 拉 伸 指定 的 区 域 ， 程 序 在 外 观 上 也 有 了 很 大 的 改进 。 有 
了 这 个 知识 储备 之 后 ， 我 们 就 可 以 进入 实战 环节 了 。 


4.7.2 编写 精美 的 聊天 界面 


既然 是 要 编写 一 个 聊天 界面 ， 那 肯定 要 有 收 到 的 消息 和 发 出 的 消息 。 上 一 小 节 中 我 们 制作 的 
message_left.9.png 可 以 作为 收 到 消息 的 背景 图 ,那么 之 无 疑问 你 还 需要 再 制作 一 张 
message_right.9.png 作 为 发 出 消息 的 背景 图 。 制 作 过 程 是 完全 一 样 的 ， 我 就 不 再 重复 演示 
Ts 


图 片 都 准备 好 了 之 后 ,就 可 以 开始 编码 了 。 由 于 待 会 我 们 会 用 有 RecyclerView , 因此 首先 需要 
在 app/build.gradle 当 中 添加 依赖 库 , 如 下 所 示 : 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation"org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 
implementation 'androidx.appcompat:appcompat:1.0.2" 
implementation "androidx.core:core-ktx:1.0.2， 
implementation 'androidx.constraintlayout:constraintlayout:1.1.3" 
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impLementation 'androidx.recyclerview:recyclerview:1.0.0' 
testImpLementation ' junit:junit:4.12， 

androidTestImpLementation "androidx.test:runner':1.1.1' 
androidTestImpLementation "androidx.test.espresso:espresso-core:3.1.1' 


接 下 来 开始 编写 主 界 面 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="#d8e0Qe8" > 


<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="Qdp" 
android:Layout weight="1" /> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" > 


<EditText 
android:id="@+id/inputText" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:hint="Type something here" 
android:maxLines="2" /> 


<Button 
android:id="@+id/send" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:text="Send" /> 


</LinearLayout> 


</LinearLayout> 


我 们 在 主 界面 中 放置 了 一 个 RecyclerView 用 于 显示 聊天 的 消息 内 容 ， 又 放置 了 一 个 EditText 用 
于 输入 消息 , 还 放置 了 一 个 Button 用 于 发 送 消息 。 这 里 用 到 的 所 有 属性 都 是 我 们 之 前 学 过 的 ， 
相信 你 理解 起 来 应 该 不 费力 。 


然后 定义 消息 的 实体 类 ,新建 Msg， 代 码 如 下 所 示 : 


class Msg(val content: String, val type: Int) { 
companion object { 
const val TYPE RECEIVED = 0 


const val TYPE SENT = 1 


Msg 类 中 只 有 两 个 字段 : content 表 示 消 息 的 内 容 ，type 表 示 消 息 的 类 型 。 其 中 消息 类 型 有 了 两 
个 值 可 选 : TYPE_RECEIVED 表 示 这 是 一 条 收 到 的 消息 , TYPE_SENT 表 示 这 是 一 条 发 出 的 消 
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虹 。 这 里 我 们 将 TYPE_RECEIVED 和 TYPE_SENT 定 义 成 了 常量 , 定义 常量 的 关键 字 是 const ， 
注意 只 有 在 单 例 类 、companion object 或 顶 层 方法 中 才 可 以 便 用 Const 关 键 字 。 


接 下 来 开始 编写 RecyclerView 的 子 项 布局 ， 新建 msg_left_ item.xml , 代码 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:padding="1l0dp" > 


<LinearLayout 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout gravity="left" 
android:background="@drawable/message left" > 


<TextView 
android:id="@+id/leftMsg" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout margin="10dp" 
android:textColor="#fff" /> 


</LinearLayout> 


</FrameLayout> 


这 是 接收 消息 的 子 项 布局 。 这 里 我 们 让 收 到 的 消息 居 左 对 齐 ， 并 使 用 message_left.9.png 作 为 


= 
月 尔 


类 似 地 ,我们 还 需要 再 编写 一 个 发 送 消息 的 子 项 布局 ,新建 msg_right_item.xml ,代码 如 下 所 
示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:padding="1l0dp" > 


<LinearLayout 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="right" 
android:background="@drawable/message right" > 


<TextView 
android:id="@+id/rightMsg" 
android:layout width= wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center" 
android:layout margin="10dp" 
android:textColor="#000" /> 


</LinearLayout> 


</FrameLayout> 


这 里 我 们 让 发 出 的 消息 居 右 对 齐 ， 并 使 用 message_right.9.png 作 为 背景 图 ,基本 上 和 刚才 的 
msg left_ item.xml 是 差不多 的 。 
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接 下 来 需要 创建 RecyclerView 的 适 配 尼 类， 新 建 类 MsgAdapter，, 代码 如 下 所 示 : 


class MsgAdapter(val msgList: List<Msg>) : RecyclerView.Adapter<RecyclerView.ViewHolder>() { 


inner class LeftViewHolder(view: View) : RecyclerView.ViewHolder(view) { 
val leftMsg: TextView = view.findViewById(R.id.leftMsg) 


} 


inner class RightViewHolder(view: View) : RecyclerView.ViewHolder(view) { 
val rightMsg: TextView = view.findViewById(R.id.rightMsg) 
} 


override fun getItemViewType(position: Int): Int { 
val msg = msgList[position] 
return msg.type 


} 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int) = if (viewType == 
Msg.TYPE RECEIVED) { 
val view = LayoutInflater.from(parent.context).inflate(R.layout.msg left item， 
parent, false) 
LeftViewHolder (view) 
} else { 
val view = LayoutIinflater.from(parent.context).inflate(R.layout.msg right item， 
parent, false) 
RightViewHolder (view) 
} 


override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) { 
val msg = msgList[position] 
when (holder) { 
is LeftViewHolder -> holder.leftMsg.text = msg.content 
is RightViewHolder -> holder.rightMsg.text = msg.content 
else -> throw IllegalArgumentException() 


} 


override fun getItemCount() = msgList.size 


} 


上 述 代码 中 用 到了 一 个 新 的 知识 点 : 根据 不 同 的 viewType 创 建 不 同 的 界面 。 首 先 我 们 定义 了 
LeftViewHolder 和 RightViewHolder 这 两 个 ViewHolder ，, 分别 用 于 缓存 

msg _left item.xml 和 msg_right item.xml 布 局 中 的 控件 。 然 后 要 重 写 
getItemViewType() 方 法 ， 并 在 这 个 方法 中 返回 当前 position 对 应 的 消息 类 型 


接 下 来 的 代码 你 应 该 就 比较 熟悉 了 ， 和 我 们 之 前 学 习 的 RecyclerView 用 法 是 比较 相似 的 ， 只 是 

要 在 onCreateViewHotLder( ) 方 法 中 根据 不 同 的 viewType 来 加 载 不 同 的 布局 并 创建 不 同 的 

ViewHolder。 然后 在 onBindViewHolder() 方法 中 判断 ViewHolder 的 类 型 : 如 果 是 

ee Rs 边 的 消息 布局 ; 如 果 是 RightViewHoLder , 就 将 内 容 
显示 到 右边 的 消息 


最 后 修改 MainActivity 中 的 代码 ， 为 RecyclerView 初 始 化 一 些 数据 ， 并 给 发 送 按钮 加 入 事件 响 
应 ， 代 码 如 下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 


private val msgList = ArrayList<Msg>() 
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private var adapter: MsgAdapter? = null 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initMsg() 
val layoutManager = LinearLayoutManager(this) 
recyclerView.layoutManager = layoutManager 
adapter = MsgAdapter (msgList) 
recyclerView.adapter = adapter 
send.setOnClickListener(this) 


} 


override fun onClick(v: View?) { 
when (v) { 
send ->{ 
val content = inputText.text.toString() 
If (content,.isNotEmpty()) { 
val msg = Msg(content, Msg.TYPE SENT) 
msgList.add(msg) 
adapter?.notifyItemInserted(msgList.size - 1) // 当 有 新 消息 时 ， 
刷新 RecyclerView 中 的 显示 
recyclerView.scrollToPosition(msgList.size - 1) // 将 RecyclerView 
定位 到 最 后 一 行 
inputText.setText("") // 清空 输入 框 中 的 内 容 


} 


private fun initMsg() { 
val msgl = Msg("Hello guy.", Msg.TYPE RECEIVED) 
msgList.add(msg]l) 
val msg2 = Msg("Hello. Who is that?", Msg.TYPE SENT) 
msgList.add(msg2) 
val msg3 = Msg("This is Tom. Nice talking to you. ", Msg.TYPE RECEIVED) 
msgList.add (msg3) 


} 


我 们 先 在 jnitMsg ( ) 方 法 中 初始 化 了 几 条 数据 用 于 在 RecyclerView 中 显示 ， 接 下 来 按照 标准 
的 方式 构建 RecyclerView , 给 它 指定 一 个 LayoutManager 和 一 个 适配器 。 


然后 在 发 送 按钮 的 点 击 事 件 里 获取 了 EditText 中 的 内 容 ， 如 果 内 容 不 为 空 字符 串 ， 则 创建 一 个 
新 的 Msg 对 象 并 添加 到 msgList 列 表 中 去 。 之 后 又 调用 了 适配器 的 notifyItemInserted() 方 

法 ， 用 于 通知 列表 有 新 的 数据 插入 ， 这 样 新 增 的 一 条 消息 才能 够 在 RecyclerView 中 显示 出 来 。 
或 者 你 也 可 以 调用 适配器 的 notifyDataSetChanged ( ) 方 法 ， 它 会 将 RecyclerView 中 所 有 可 
见 的 元 素 全 部 刷新 ， 2 管 是 新 增 、 删 除 、 还 是 修改 元 素 ， 界 面 上 都 会 显示 最 新 的 数据 ,但 
缺点 是 效率 会 相对 差 一 些 。 接 着 调用 RecyclerView 的 scroLLToPosition( ) 方 法 将 显示 的 数 
据 定位 到 最 后 一 行 ， 本 定 可 以 看 得 到 最 后 发 出 的 一 条 消息 。 最 后 调用 EditText 的 
setText ( ) 方 法 将 输入 的 内 容 清 空 。 


这 样 所 有 的 工作 都 完成 了 ， 终 于 可 以 检验 一 下 我 们 的 成 果 了 。 运 行程 序 之 后 ， 你 将 会 看 到 非常 
美观 的 聊天 界面 ， 并 且 可 以 输入 和 发 送 消息 ,如 图 4.45 所 示 。 
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Hello guy 


Hello. Who is that? 


This is Tom. Nice talking to you. 


Surel SEND 


图 4.45 精美 的 聊天 界面 


相信 这 个 例子 的 实战 过 程 不 仅 加 深 了 你 对 本 章 中 所 学 UI 知识 的 理解 ， 还 让 你 有 了 如 何 灵活 运用 
这 些 知识 来 设计 出 优秀 界面 的 思 
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4.8 Kotlin 课 堂 : 延迟 初始 化 和 密封 类 


结束 了 干货 满 满 的 一 整 章 ， 现 在 又 来 到 最 受 期 待 的 Kotlin 课 堂 了 。 我 之 前 说 过 ， 每 章 的 Kotlin 课 
堂 都 会 结合 当前 章节 的 内 容 来 拓展 出 Kotlin 更 多 的 使 用 技巧 ， 那 么 本 章 可 以 拓展 哪些 知识 点 呢 ? 
这 里 我 已 经 帮 你 安排 好 了 , 本 节 的 Kotlin 课 堂 ， 我 们 就 来 学 习 延 迟 初始 化 和 密封 类 这 两 部 分 内 


4.8.1 对 变量 延迟 初始 化 


前 面 我 们 已 经 学 习 了 Kotlin 语 言 的 许多 特性 ， 包 括 变量 不 可 变 ， 变 量 不 可 为 空 ， 等 等 。 这 些 特 性 
都 是 为 了 尽 可 能 地 保证 程序 安全 而 设计 的 ， 但 是 有 些 时 候 这 些 特性 也 会 在 编码 时 给 我 们 带 来 不 
少 的 麻烦 。 


比如 ,如 果 你 的 类 中 存在 很 多 全 局 变量 实例 ， 为 了 保证 它们 能 够 满足 Kotlin 的 空 指针 检查 语法 标 
准 ， 你 不 得 不 做 许多 的 非 空 判 断 保护 才 行 ， 即 使 你 非常 确定 它们 不 会 为 空 。 


下 面 我 们 通过 一 个 具体 的 例子 来 看 一 下 吧 ， 就 使 用 刚刚 的 UIBestPractice 项 目 来 作为 例子 。 如 
果 你 仔细 观察 MainActivity 中 的 代码 ， 会 发 现 这 里 适配器 的 写法 略微 有 点 特殊 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 
private var adapter: MsgAdapter? = null 
override fun onCreate(savedInstanceState: Bundle?) { 
adapter = MsgAdapter (msgList) 
和 
override fun onClick(v: View?) { 


adapter?.notifyItemInserted(msgList.size - 1) 


} 


这 里 我 们 将 adapter 设 置 为 了 全 局 变量 ， 但 是 它 的 初始 化 工作 是 在 onCreate( ) 方 法 中 进行 
的 ， 因 此 不 得 不 先 将 adapter 赋 值 为 nuLL，, 同时 把 它 的 类 型 声明 成 MsgAdapter?。 


虽然 我 们 会 在 onCreate ( ) 方 法 中 对 adapter 进 行 初始 化 ， 同 时 能 确保 onCLick( ) 方 法 必然 在 
onCreate( ) 方 法 之 后 才 会 调用 ， 但 是 我 们 在 onCLick( ) 方 法 中 调用 adapter 的 任何 方法 时 仍 
然 要 进行 判 空 处 理 才 行 ， 否 则 编译 肯定 无 法 通过 。 


而 当 你 的 代码 中 有 了 越 来 越 多 的 全 局 变量 实例 时 ， 这 个 问题 就 会 变 得 越 来 越 明显 ， 到 时 候 你 可 
能 必须 编 瑟 大 量 额外 的 判 空 处 理 代码 ， 只 是 为 了 满足 Kotlin 编 译 费 的 要 求 。 

幸运 的 是 ， 这 个 问题 其 实 是 有 解决 办 法 的 ， 而 且 非 常 简单 ， 那 就 是 对 全 局 变量 进行 延迟 初始 
化 。 
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延迟 初始 化 使 用 的 是 Lateinit 关 键 字 , 它 可 以 告诉 Kotlin 编 译 屁 ， 我 会 在 晚 些 时 候 对 这 个 变量 
进行 初始 化 ， 这 样 就 不 用 在 一 开始 的 时 候 将 它 赋 值 为 nuLL 了 。 


接 下 来 我 们 就 使 用 延迟 初始 化 的 方式 对 上 述 代码 进行 优化 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity(), View.OnClickListener { 
private lateinit var adapter: MsgAdapter 
override fun onCreate(savedInstanceState: Bundle?) { 
adapter = MsgAdapter (msgList) 
je 
override fun onClick(v: View?) { 


adapter.notifyItemInserted(msgList.size - 1) 


} 


可 以 看 到 ,我们 在 adapter 变 量 的 前 面 加 上 了 Tateinit 关 键 字 ， 这样 就 不 用 在 一 开始 的 时 候 

将 它 赋 值 为 nuLL， 同时 类 型 声明 也 就 可 以 改 成 MsgAdapter 了 。 由 于 MsgAdapter 是 不 可 为 空 
的 类 型 ， 所 以 我 们 在 onCLick ( ) 方 法 中 也 就 不 再 需要 进行 判 空 处 理 ， 直接 调用 adapter 的 任何 
方法 就 可 以 了 。 


当然 ， 使 用 Lateinit 关 键 字 也 不 是 没有 任何 风险 ， 如 果 我 们 在 adapter 变 量 还 没有 初始 化 的 
情况 下 就 直接 使 用 它 ， 那 么 程序 就 一 定 会 崩 演 ， 并且 抛 出 一 个 
UninitializedPropertyAccessException 异 常 ， 如 图 4.46 所 示 。 


Caused by: kotlin.UninitializedPropertyAccessException: lateinit property adapter has not been initialized 
at com.example.uibestpractice.MainActivity,.onCreate(MainActivity, kt;22) 
at android,app.Activity.performCreate( 6) 
at android,app.Activity,.performCreate(Arc 27) 
at android,.app.Instrumentation.callActivityOnCreate( 5 5 ) 


图 4.46 抛 出 UninitializedPropertyAccessException 异 常 


所 以 ， 当 你 对 一 个 全 局 变量 使 用 了 Lateinit 关 键 字 时 ， 请 一 定 要 确保 它 在 被 任何 地 方 调用 之 前 
已 经 完成 了 初始 化 工作 ， 否则 Kotlin 将 无 法 保证 程序 的 安全 性 。 
另外 ， 我 们 还 可 以 通过 代码 来 判断 一 个 全 局 变量 是 否 已 经 完成 了 初始 化 ， 这 样 在 某 些 时 候 能 够 
有 效 地 避免 重复 对 某 一 个 变量 进行 初始 化 操作 ， 示例 代 码 如 下 : 
class MainActivity : AppCompatActivity(), View.OnClickListener { 

private lateinit var adapter: MsgAdapter 

override fun onCreate(savedInstanceState: Bundle?) { 

if (!::adapter.isInitialized) { 


adapter = MsgAdapter (msgList) 
} 
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} 


具体 语法 就 是 这 样 ，: :adapter.isInitiaLized 可 用 于 判断 adapter 变 量 是 否 已 经 初始 
化 。 虽 然 语 法 看 上 去 有 点 奇怪 ， 但 这 是 固定 的 写法 。 然 后 我 们 再 对 结果 进行 取 反 ， 如 果 还 没有 
初始 化 ， 那 么 就 立即 对 adapter 变 量 进行 初始 化 ,否则 什么 都 不 用 做 。 


以 上 就 是 关于 延迟 初始 化 的 所 有 重要 内 容 ， 剩 下 的 就 是 在 合理 的 地 方 使 用 它 了 ， 相信 这 对 于 你 
来 说 并 不 是 什么 难题 。 


4.8.2 使 用 密封 类 优化 代码 

由 于 密封 类 通常 可 以 结合 RecyclerView 适 配器 中 的 ViewHolder 一 起 使 用 ， 因 此 我 们 就 正好 借 
这 个 机 会 在 本 节 学 习 一 下 它 的 用 法 。 当 然 ， 密 封 类 的 使 用 场景 远 不 止 于 此 ， 它 可 以 在 很 多 时 候 
帮助 你 写 出 更 加 规范 和 安全 的 代码 ， 所 以 非常 值得 一 学 。 


首先 来 了 解 一 下 密封 类 具体 的 作用 ， 这 里 我 们 来 看 一 个 简单 的 例子 。 新 建 一 个 Kotlin 文 件 ,文件 
名 就 叫 Result,kt 好 了 ， 然 后 在 这 个 文件 中 编写 如 下 代码 : 


interface Result 
class Success(val msg: String) : Result 
class Failure(val error: Exception) : Result 


这 里 定义 了 一 个 Result 接 口 ， 用 于 表示 某 个 操作 的 执行 结果 ， 接口 中 不 用 编写 任何 内 容 。 然 后 
定义 了 两 个 类 去 实现 Result 接 口 : 一 个 Success 类 用 于 表示 成 功 时 的 结果 ,一 个 Failure 类 
用 于 表示 失败 时 的 结果 ， 这样 就 把 准备 工作 做 好 了 。 


接 下 来 再 定义 一 个 getResultMsg() 方 法 ,用 于 获取 最 终 执行 结果 的 信息 ,代码 如 下 所 示 : 


fun getResultMsg(result: Result) = when (result) { 
is Success -> result.msg 
is Failure -> result.error.message 


else -> throw IllegalArgumentException() 


} 


getResultMsg() 方 法 中 接收 一 个 Result 参 数 。 我 们 通过 when 语 句 来 判断 : 如 果 Result 属 
于 Success，, 那么 就 返回 成 功 的 消息 ; 如 果 Result 属 于 Failure，, 那么 就 返回 错误 信息 。 到 
目前 为 止 ， 代 码 都 是 没有 问题 的 ,但 比较 让 人 讨厌 的 是 ， 接 下 来 我 们 不 得 不 再 编写 一 个 eLse 条 
件 ， 否则 Kotlin 编 译 器 会 认为 这 里 缺少 条 件 分 支 ， 代 码 将 无 法 编译 通过 。 但 实际 上 ResutLt 的 执 
行 结果 只 可 能 是 SuccesSs 或 者 FaiLure , 这 个 eLse 条 件 是 永远 走 不 到 的 ， 所 以 我 们 在 这 里 直接 
抛 出 了 一 个 异常 ， 只 是 为 了 满足 Kotlin 编 译 器 的 语法 检查 而 已 。 


另外 ,编写 eLse 条 件 还 有 一 个 潜在 的 风险 。 如 果 我 们 现在 新 增 了 一 个 Unknown 类 并 实现 
ResutLt 接 口 ， 用 于 表示 未 知 的 执行 结果 ,但 是 忘记 在 getResuLtMsg ( ) 方 法 中 添加 相应 的 条 
件 分 支 ， 编 译 器 在 这 种 情况 下 是 不 会 提醒 我 们 的 ， 而 是 会 在 运行 的 时 候 进 入 eLse 条 件 里 面 ， 从 
而 抛 出 异常 并 导致 程序 衣 溃 。 


当然 ， 这 种 为 了 满足 编译 器 的 要 求 而 编写 无 用 条 件 分 支 的 情况 不 仅 在 Kotlin 当 中 存在 ， 在 Java 或 
者 是 其 他 编程 语言 当中 也 普遍 存在 。 
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不 过 好 消息 是 ，Kotlin 的 密封 类 可 以 很 好 地 解决 这 个 问题 ， 下 面 我 们 就 来 学 习 一 下 。 


密封 类 的 关键 字 是 sealed class , 它 的 用 法 同样 非常 简单 ， 我 们 可 以 轻松 地 将 Result 接 口 改 
造成 密封 类 的 写法 : 


sealed class Result 
class Success(val msg: String) : Result() 
class Failure(val error: Exception) : Result() 


可 以 看 到 ， 代码 并 没有 什么 太 大 的 变化 ,只 是 将 ijnterface 关 键 字 改 成 了 sealed class。 另 
外 ,由 于 密封 类 是 一 个 可 继承 的 类 ， 因 此 在 继承 它 的 时 候 需 要 在 后 面 加 上 一 对 括号 ， 这 一 点 我 
们 在 第 2 章 就 学 习 过 了 。 


那么 改 成 密封 类 之 后 有 什么 好 处 呢 ? 你 会 发 现 现在 getResultMsg( ) 方 法 中 的 else 条 件 已 经 不 
再 需要 了 ， 如 下 所 示 : 


fun getResultMsg(result: Result) = when (result) { 
is Success -> result.msg 
is Failure -> "Error is ${result.error.message}" 


} 


为 什么 这 里 去 掉 了 etLse 条 件 仍然 能 编译 通过 呢 ? 这 是 因为 当 在 when 语 名 中 传 入 一 个 密封 类 变量 
作为 条 件 时 ，Kotlin 编 译 器 会 自动 检查 该 密封 类 有 哪些 子 类 ， 并 强制 要 求 你 将 每 一 个 子 类 所 对 应 
的 条 件 全 部 处 理 。 这 样 就 可 以 保证 ， 即 使 没有 编写 eLse 条 件 ， 也 不 可 能 会 出 现 漏 写 条 件 分 支 的 
情况 。 而 如 果 我 们 现在 新 增 一 个 Unknown 类 ， 并 也 让 它 继承 自 ResuLt ,此 时 
getResuLtMsg ( ) 方 法 就 一 定 会 报错 ， 必 须 增 加 一 个 Unknown 的 条 件 分 支 才能 让 代码 编译 通 


这 就 是 密封 类 主要 的 作用 和 使 用 方法 了 。 另 外 再 多 说 一 名 ， 密 封 类 及 其 所 有 子 类 只 能 定义 在 同 
一 个 文件 的 顶层 位 置 ， 不 能 嵌 套 在 其 他 类 中 ， 这 是 被 密封 类 底层 的 实现 机 制 所 限制 的 。 


了 解 了 这 么 多 关于 密封 类 的 知识 ， 接 下 来 我 们 看 一 下 它 该 如 何 结合 MsgAdapter 中 的 
ViewHolder 一 起 使 用 ， 并 顺便 优化 一 下 MsgAdapter 中 的 代码 。 


观看 MsgAdapter 现 在 的 代码 ， 你 会 发 现 onBindViewHotLder() 方 法 中 就 存在 一 个 没有 实际 作 
用 的 eLse 条 件 ， 只 是 抛 出 了 一 个 异常 而 已 。 对 于 这 部 分 代码 ， 我 们 就 可 以 借助 密封 类 的 特性 来 
进行 优化 。 首 先 删除 MsgAdapter 中 的 LeftViewHolder 和 RightViewHolder , 然后 新 建 一 个 
MsgViewHolder.kt 文 件 ， 在 其 中 加 入 如 下 代码 : 


sealed class MsgViewHolder(view: View) : RecyclerView.ViewHolder(view) 
class LeftViewHolder(view: View) : MsgViewHolder(view) { 

val LeftMsg: TextView = view.findViewById(R.id.leftMsg) 
} 


class RightViewHolder(view: View) : MsgViewHolder(view) { 
val rightMsg: TextView = view.findViewById(R.id.rightMsg) 
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这 里 我 们 定义 了 一 个 密封 类 MsgViewHolder ,并 让 它 继承 自 RecyclerView.ViewHolder， 
然后 让 LeftViewHolder 和 RightViewHolder 继 承 自 MsgViewHolder。 这 样 就 相当 于 密封 
类 MsgViewHoLder 只 有 两 个 已 知 子 类 ， 因 此 在 when 语 句 中 只 要 处 理 这 两 种 情况 的 条 件 分 支 即 


可 。 
现在 修改 MsgAdapter 中 的 代码 , 如 下 所 示 : 


class MsgAdapter(val msgList: List<Msg>) : RecyclerView.Adapter<MsgViewHolder>() { 


override fun onBindViewHolder(holder: MsgViewHolder, position: Int) { 
val msg = msgList[position] 
when (holder) { 
is LeftViewHolder -> holder.leftMsg.text = msg.content 
is RightViewHolder -> holder.rightMsg.text = msg.content 


} 


} 
这 里 我 们 将 RecyclerView.Adapter 的 涝 型 指定 成 刚刚 定义 的 密封 类 Ms gViewHolder , 这样 
onBindViewHolder() 方 法 传 入 的 参数 就 变 成 了 MsgViewHolder。 然 后 我 们 只 要 在 when 语 

句 当中 处 理 LeftViewHoLder 和 RightViewHoLder 这 两 种 情况 就 可 以 了 ， 那 个 讨厌 的 eLse 终 


于 不 再 需要 了 ， 这 种 RecyclerView 适 配器 的 写法 更 加 规范 也 更 加 推荐 。 
通过 本 次 Kotlin 课 堂 的 学 习 ，UIBestPractice 项 目 中 的 代码 现在 变 得 更 加 完善 了 。 这 一 章 你 也 
学 到 了 不 少 东 西 ， 让 我 们 来 总 结 一 下 吧 。 
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4.9 ”小结 与 点 评 


虽然 本 章 的 内 容 很 多 ， 但 我 觉得 学 习 起 来 应 该 还 是 挺 愉快 的 吧 。 不 同 于 上 一 章 中 我 们 来 来 回回 
使 用 那 几 个 按钮 ， 本 章 可 以 说 是 使 用 了 各 种 各 样 的 控件 ， 制 作出 了 丰富 多 彩 的 界面 。 尤 其 是 在 
最 佳 实践 环节 ， 编 写 出 了 那么 精美 的 聊天 界面 ， 你 的 满足 感应 该 比 上 一 章 还 要 强 吧 ? 


本 章 从 Android 中 的 一 些 常见 控件 入 手 ， 依 次 介绍 了 基本 布局 的 用 法 、 自 定义 控件 的 方法 、 
ListView 的 详细 用 法 以 及 RecyclerView 的 使 用 ， 基 本 已 经 将 重要 的 UI 知识 点 全 部 覆盖 了 。 另 外 
在 最 后 的 Kotlin 课 堂 中 ,我们 还 学 习 了 延迟 初始 化 和 密封 类 的 用 法 ， 并 借助 它们 进一步 完善 了 最 
佳 实践 环节 的 代码 ， 结 合 实例 来 学 习 ， 相 信 你 已 经 将 这 些 知 识 点 掌握 得 非常 牢固 了 。 

不 过 到 目前 为 止 ， 我 们 还 只 是 学 习 了 Android 手 机 方面 的 开发 技巧 ， 下 一 章 将 会 涉及 一 些 
Android 平 板 方面 的 知识 点 ， 能 够 同时 兼容 手机 和 平板 也 是 自 Android 4.0 系 统 开始 就 支持 的 特 
性 。 适 当地 放松 和 休息 一 段 时 间 后 ,我们 再 来 继续 前 行 吧 ! 
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第 5 章 手机 平板 要 兼顾 ,探究 Fragment 


当今 是 移动 设备 发 展 非常 迅速 的 时 代 ， 不 仪 手机 已 经 成 为 了 生活 必需 品 ， 而 且 平板 也 变 得 越 来 
越 普 及 。 平 板 和 手机 最 大 的 区 别 就 在 于 屏幕 的 大 小 : 一 般 手机 屏幕 的 大 小 在 3 英寸 到 6 英寸 之 

间 ， 平 板 屏幕 的 大 小 在 7 英寸 到 10 英 寸 之 间 。 屏 幕 大 小 差距 过 大 有 可 能 会 让 同样 的 界面 在 视觉 效 
果 上 有 较 大 的 差异 ， 比 如 一 些 界 面 在 手机 上 看 起 来 非常 美观 ， 但 在 平板 上 看 起 来 可 能 会 有 控件 
被 过 分 拉 长 、 元 素 之 间 空 隙 过 大 等 情况 。 

对 于 一 名 专业 的 Android 开 发 人 员 而 言 ， 能够 兼顾 手机 和 平板 的 开发 是 我 们 尽 可 能 要 做 到 的 事 


情 。Android 自 3.0 版 本 开始 引入 了 Fragment 的 概念 ， 它 可 以 让 界面 在 平板 上 更 好 地 展示 ， 下 
面 我 们 就 一 起 来 学 习 一 下 。 
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5.1 Fragment 是 什么 


Fragment 是 一 种 可 以 容 入 在 Activity 当 中 的 UI 片段 , 它 能 让 程序 更 加 合理 和 充分 地 利用 大 屏幕 
的 空间 ， 因 而 在 平板 上 应 用 得 非常 广泛 。 虽 然 Fragment 对 你 来 说 是 个 全 新 的 概念 ， 但 我 相信 你 
学 习 起 来 应 该 之 不 费力 ， 因 为 它 和 Activity 实 在 是 太 像 了 ， 同样 都 能 包含 布局 ,同样 都 有 自己 的 
生命 周期 。 你 甚至 可 以 将 Fragment 理 解 成 一 个 迷你 型 的 Activity ,虽然 这 个 迷你 型 的 Activity 

有 可 能 和 普通 的 Activity 是 一 样 大 的 。 


那么 究竟 要 如 何 使 用 Fragment 才 能 充分 地 利用 平板 屏幕 的 空间 呢 ? 想象 我 们 正在 开发 一 个 新 闻 
应 用 ,其 中 一 个 界面 使 用 RecyclerView 展 示 了 一 组 新 闻 的 标题 ， 当 点 击 其 中 一 个 标题 时 ， 就 打 
开 另 一 个 界面 显示 新 闻 的 详细 内 容 。 如 果 是 在 手机 中 设计 ， 我 们 可 以 将 新 闻 标 题 列 表 放 在 一 个 
Activity 中 ， 将 新 闻 的 详细 内 容 放 在 另 一 个 Activity 中 ， 如 图 5.1 所 示 。 


新 闻 1 标题 
新 闻 2 
新 闻 3 

内 容 
新 闻 4 
新 闻 5 


图 5.1 手机 的 设计 方案 


可 是 如 果 在 平板 上 也 这 么 设计 ， 那 么 新 闻 标 题 列表 将 会 被 拉 长 至 填充 满 整 个 平板 的 屏幕 ,而 新 
闻 的 标题 一 般 不 会 太 长 ， 这 样 将 会 导致 界面 上 有 大 量 的 空白 区 域 ， 如 图 5.2 所 示 。 
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图 5.2 平板 的 新 闻 列 表 


因此 , 更 好 的 设计 方案 是 将 新 闻 标题 列表 界面 和 新 闻 详细 内 容 界 面 分 别 放 在 两 个 Fragment 中 ， 
然后 在 同一 个 Activity 里 引入 这 两 个 Fragment ,这 样 就 可 以 将 屏幕 空间 充分 地 利用 起 来 了 ， 如 


图 5.3 所 示 。 


图 5.3 平板 的 双 页 设计 
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5.2 Fragment 的 使 用 方式 

介绍 了 这 么 多 抽象 的 东西 ， 是 时 候 学 习 一 下 Fragment 的 具体 用 法 了 。 首 先 我 们 要 创建 一 个 平板 
模拟 器 ， 创 建 模 拟 器 的 方法 在 第 1 章 中 已 经 学 过 了 ,这 里 就 不 再 殴 述 。 这 次 我 们 选择 创建 一 个 
Pixel C 平 板 模拟 器 ， 创 建 完成 后 启动 模拟 器 ， 效果 如 图 5.4 所 示 。 


Monday 副 Junil7， 


图 5.4 平板 模拟 器 的 运行 效果 


好 了 ， 准备 工作 都 完成 了 ， 接 着 新 建 一 个 FragmentTest 项 目 ， 然 后 开始 我 们 的 Fragment 探 索 
之 旅 吧 。 


5.2.1 Fragment 的 简单 用 法 


这 里 我 们 准备 先 与 一 个 最 简单 的 Fragment 示 例 来 练 练 手 。 在 一 个 Activity 当 中 添加 两 个 
Fragment , 并 让 这 两 个 Fragment 平 分 Activity 的 空间 。 


新 建 一 个 左 侧 Fragment 的 布局 left_ fragment.xml ,代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/button" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:Layout gravity="center horizontal" 
android:text="Button" 
/> 
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</LinearLayout> 


这 个 布局 非常 简单 ， 只 放置 了 一 个 按钮 ， 并 让 它 水 平 居 中 显示 。 
然后 新 建 右 侧 Fragment 的 布局 right fragment.xml ,代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#00ff00" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout gravity="center horizontal" 
android:textSize="24sp" 
android:text="This is right fragment" 
/> 


</LinearLayout> 


可 以 看 到 ， 我们 将 这 个 布局 的 背景 色 设置 成 了 绿色 ， 并 放置 了 一 个 TextView 用 于 显示 一 段 文 
本 。 


接着 新 建 一 个 LeftFragment 类 ， 并 让 它 继承 自 Fragment。 注 意 ,这 里 可 能 会 有 两 个 不 同 包 
下 的 Fragment 供 你 选择 : 一 个 是 系统 内 置 的 android.app.Fragment , 一 个 是 AndroidX 库 中 
的 androidx.fragment.app.Fragment。 这 里 请 一 定 要 使 用 AndroidX 库 中 的 Fragment ， 
为 它 可 以 让 Fragment 的 特性 在 所 有 Android 系 统 版 本 中 保持 一 致 ， 而 系统 内 置 的 FFagment 在 
Android 9.0 版 本 中 已 被 废弃 。 使 用 AndroidX 库 中 的 FrFagment 并 不 需要 在 build.gradle 文 件 
中 添加 额外 的 依赖 ， 只 要 你 在 创建 新 项 目 时 多 选 了 Use androidx.* artifacts 选 项 , Android 
Studio 会 自动 帮 你 导入 必要 的 AndroidX 库 。 


现在 编写 一 下 LeftFragment 中 的 代码 ， 如 下 所 示 : 


class LeftFragment : Fragment() { 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
return inflater.inflate(R.layout.left fragment, container, false) 


} 


这 里 仅仅 是 重 写 了 Fragment 的 onCreateView() 方 法 ,然后 在 这 个 方法 中 通过 
Layoutlnflater 的 infLate() 方 法 将 刚才 定义 的 left_ fragment 布局 动态 加 载 进来 ， 整 个 方法 
简单 明了 。 接 着 我 们 用 同样 的 方法 再 新 建 一 个 RightFragment， 代码 如 下 所 示 : 


class RightFragment : Fragment() { 
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 


savedInstanceState: Bundle?): View? { 
return inflater.inflate(R.layout.right fragment, container, false) 
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} 


代码 基本 上 是 相同 的 ， 相 信 已 经 没有 必要 再 做 什么 解释 了 。 接 下 来 修改 activity_main.xml 中 的 
代码 ,如 下 所 示 : 


<fragment 


<fragment 


</LinearLayout> 


android: 
android: 
android: 
android: 
android: 


android: 
android: 
android: 
android: 
android: 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


id="@+id/leftFrag" 
name="com.example.fragmenttest.LeftFragment" 
Layout width="0dp" 

Layout height="match parent" 

layout weight="1" /> 


id="@+id/rightFrag" 
name="com.example.fragmenttest.RightFragment" 
Layout width="0dp" 

Layout height="match parent" 

layout weight="1" /> 


a iy ragment> 标 签 在 布局 中 添加 Fragment , 其 中 指定 的 大 多 数 属性 你 已 
经 非常 熟悉 了 ， 只 不 过 这 里 还 需要 通过 android:name 属 性 来 显 式 声明 要 添加 的 Fragment 类 
名 ， 注 意 一 定 要 将 类 的 包 名 也 加 上 。 


这 样 最 简单 的 Fragment 示 例 就 已 经 写 好 了 “， 现在 运行 一 下 程序 , 效果 如 图 5.5 所 示 。 


10:39 


FragmentTest 


图 5.5 ”Fragment 的 简单 运行 效果 
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正如 我 们 预期 的 一 样 ， 两 个 Fragment 平 分 了 整个 Activity 的 布局 。 不 过 这 个 例子 实在 是 太 简单 
了 ， 在 真正 的 项 目 中 很 难 有 什么 实际 的 作用 ， 因 此 下 面 我 们 马上 来 看 一 看 , 关于 Fragment 更 加 
高 级 的 使 用 技巧 。 


5.2.2 动态 添加 Fragment 


在 上 一 节 当 中 ， 你 已 经 学 会 了 在 布局 文件 中 添加 Fragment 的 方法 , 不 过 Fragment 真 正 的 强大 
之 处 在 于 ， 它 可 以 在 程序 运行 时 动态 地 添加 到 Activity 当 中 。 根 据 具 体 情况 来 动态 地 添加 
Fragment , 你 就 可 以 将 程序 界面 定制 得 更 加 多 样 化 。 


我 们 在 上 一 节 代 码 的 基础 上 继续 完善 ， 新 建 another_right fragment.xml , 代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:background="#ffff00" 
android:layout width="match parent" 
android:layout height="match parent"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:textSize="24sp" 
android:text="This is another right fragment" 
/> 


</LinearLayout> 


这 个 布局 文件 的 代码 和 right_fragment.xm lI 中 的 代码 基本 相同 ， 只 是 将 背景 色 改 成 了 黄色 ,并 
将 显示 的 文字 改 了 改 。 然 后 新 建 AnotherRightFragment 作 为 男 一 个 右 侧 Fragment ,代码 如 
下 所 示 : 


class AnotherRightFragment : Fragment() { 
override fun onCreateView(inflater: LayoutInfLater，container: ViewGroup?, 


savedInstanceState: Bundle?): View? { 
return inflater.inflate(R.layout.another right fragment, container, false) 


} 


代码 同样 非常 简单 ， 在 onCreateView( ) 方 法 中 加 载 了 刚刚 创建 的 another_right fragment 
布局 。 这 样 我 们 就 准备 好 了 另 一 个 Fragment , 接 下 来 看 一 下 如 何 将 它 动态 地 添加 到 Activity 当 
中 。 修 改 activity_main.xml , 代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/leftFrag" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="Qdp" 
android:layout height="match parent" 
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android:Layout weight="1" /> 


<FrameLayout 
android:id="@+id/rightLayout" 
android:layout width="Qdp" 
android:layout height="match parent" 
android:layout weight="1" > 
</FrameLayout> 


</LinearLayout> 


可 以 看 到 ， 现 在 将 右 侧 Fragment 蔡 换 成 了 一 个 FrameLayout。 还 记得 这 个 布局 吗 ? 在 上 一 章 
中 我 们 学 过 ,这 是 Android 中 最 简单 的 一 种 布局 ， 所 有 的 控件 默认 都 会 摆 放 在 布局 的 左上 角 。 由 
于 这 里 仅 需要 在 布局 里 放 入 一 个 Fragment , 不 需要 任何 定位 ， 因 此 非常 适合 使 用 


FrameLayout, 
下 面 我 们 将 在 代码 中 向 FrameLayout 里 添加 内 容 ， 从 而 实现 动态 添加 Fragment 的 功能 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
button.setOnClickListener { 
replaceFragment (AnotherRightFragment()) 


} 
replaceFragment (RightFragment()) 
} 


private fun replaceFragment(fragment: Fragment) { 
val fragmentManager = supportFragmentManager 
val transaction = fragmentManager.beginTransaction() 
transaction.replace(R.id.rightLayout, fragment) 
transaction.commit() 


} 


可 以 看 到 ， 首先 我 们 给 左 侧 Fragment 中 的 按钮 注册 了 一 个 点 击 事件 ,然后 调用 
replaceFragment() 方 法 动态 添加 了 RightFragment。 当 点 击 左 侧 Fragment 中 的 按钮 时 ， 
又 会 调用 replaceFragment() 方 法 , 将 右 侧 Fragment 替 换 成 AnotherRightFragment。 结 
合 replaceFragment() 方 法 中 的 代码 可 以 看 出 ， 动 态 添加 Fragment 主 要 分 为 5 步 。 


(1) 创建 待 添加 Fragment 的 实例 。 

(2) 获取 FragmentManager , 在 Activity 中 可 以 直接 调用 getSupportFragmentManager() 
方法 获取 。 

(3) 开启 一 个 事务 ， 通 过 调用 beginTransaction() 方 法 开启 。 


(4) 向 容器 内 添加 或 替换 Fragment , 一 般 使 用 repLace ( ) 方 法 实现 ， 需 要 传 入 容器 的 id 和 待 添 
加 的 Fragment 实 例 。 


(5) 提交 事务 ， 调 用 commit ( ) 方 法 来 完成 。 


www.blogss.cn 


这 样 就 完成 了 在 Activity 中 动态 添加 Fragment 的 功能 ， 重 新 运行 程序 ， 可 以 看 到 和 和 之 前 相同 的 
界面 ,然后 点 击 一 下 按钮 ,效果 如 图 5.6 所 示 。 


FragmentTest 


图 5.6 ”动态 添加 Fragment 的 效果 


5.2.3 在 Fragment 中 实现 返回 栈 


在 上 一 小 节 中 ,我们 成 功 实现 了 向 Activity 中 动态 添加 Fragment 的 功能 。 不 过 你 尝试 一 下 就 会 
发 现 ,通过 点 击 按钮 添加 了 一 个 Fragment 之 后 ,这 时 按 下 Back 键 程序 就 会 直接 退出 。 如 果 我 
们 想 实现 类 似 于 返回 栈 的 效果 ， 按 下 Back 键 可 以 回 到 上 一 个 Fragment , 该 如 何 实现 呢 ? 


其 实 很 简单 ，FragmentTransaction 中 提供 了 一 个 addToBackStack() 方 法 ,可 以 用 于 将 一 
个 事务 添加 到 返回 栈 中 。 修 改 MainActivity 中 的 代码 , 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


private fun replaceFragment(fragment: Fragment) { 
val fragmentManager = supportFragmentManager 
val transaction = fragmentManager.beginTransaction() 
transaction.replace(R.id.rightLayout, fragment) 
transaction.addToBackStack (null) 
transaction.commit() 


} 


这 里 我 们 在 事务 提交 之 前 调用 了 FragmentTransaction 的 addToBackStack() 方 法 , 它 可 以 
接收 一 个 名 字 用 于 描述 返回 栈 的 状态 ， 一 般 传 入 nuLL 即 可 。 现 在 重新 运行 程序 ， 并 点 击 按钮 将 
AnotherRightFragment 添 加 到 Activity 中 ， 然 后 按 下 Back 键 ， 你 会 发 现 程序 并 没有 退出 ， 而 
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是 回 到 了 RightFragment 界 面 。 继 续 按 下 Back 键 ，RightFragment 界 面 也 会 消失 ， 再 次 按 下 
Back 键 ， 程 序 才 会 退出 。 


5.2.4 Fragment 和 Activity 之 间 的 交互 


虽然 Fragment 是 肉 入 在 Activity 中 显示 的 ， 可 是 它们 的 关系 并 没有 那么 亲密 。 实 际 上 ， 
Fragment 和 Activity 是 各 自 存 在 于 一 个 独立 的 类 当中 的 ， 它 们 之 间 并 没有 那么 明显 的 方式 来 直 
接 进行 交互 。 如 果 想 要 在 Activity 中 调用 Fragment 里 的 方法 , 或 者 在 Fragment 中 调用 
Activity 里 的 方法 ， 应 该 如 何 实现 呢 ? 


为 了 方便 Fragment 和 Activity 之 间 进 行 交互 ，FragmentManager 提 供 了 一 个 类 似 于 
findViewById( ) 的 方法 , 专门 用 于 从 布局 文件 中 获取 Fragment 的 实例 ， 代码 如 下 所 示 : 


val fragment = SupportFragmentManager .findFragmentById(R.id.LeftFrag) as LeftFragment 


调用 FragmentManager 的 findFragmentById () 方 法 ， 可 以 在 Activity 中 得 到 相应 
Fragment 的 实例 ,然后 就 能 轻松 地 调用 Fragment 里 的 方法 了 。 


另外 ， 类 似 于 findViewById() 方 法 ,kotlin-android-extensions 插 件 也 对 
findFragmentById () 方 法 进行 了 扩展 ， 人 允许 我 们 直接 使 用 布局 文件 中 定义 的 Fragment id 名 
称 来 自动 获取 相应 的 Fragment 实 例 ， 如 下 所 示 : 


val fragment = LeftFrag as LeftFragment 


那么 之 无 疑问 ,第 二 种 写法 是 我 们 现在 更 加 推荐 的 写法 。 


掌握 了 如 何在 Activity 中 调用 Fragment 里 的 方法 ， 那 么 在 Fragment 中 又 该 怎样 调用 Activity 
里 的 方法 呢 ? 这 就 更 简单 了 ， 在 每 个 rragment 中 都 可 以 通过 调用 getActivity ( ) 方 法 来 得 到 
和 当前 Fragment 相 关联 的 Activity 实 例 ， 代 码 如 下 所 示 : 


if (activity != null) { 
val mainActivity = activity as MainActivity 
} 


这 里 由 于 getActivity() 方 法 有 可 能 返回 null , 因此 我 们 需要 先进 行 一 个 判 空 处 理 。 有 了 
Activity 的 实例 ， 在 Fragment 中 调用 Activity 里 的 方法 就 变 得 轻而易举 了 。 另 外 当 Fragment 
中 需要 使 用 Context 对 象 时 ,也 可 以 使 用 getActivity () 方 法 ， 因 为 获取 到 的 Activity 本 身 就 
是 一 个 Context 对 象 。 


这 时 不 知道 你 心中 会 不 会 产生 一 个 疑问 : 既然 Fragment 和 Activity 之 间 的 通信 问题 已 经 解决 
了 ,那么 不 同 的 Fragment 之 间 可 不 可 以 进行 通信 呢 ? 


说 实在 的 ， 这 个 问题 并 没有 看 上 去 那么 复杂 , 它 的 基本 思路 非常 简单 : 首先 在 一 个 Fragment 中 


可 以 得 到 与 它 相 关联 的 Activity， 然后 再 通过 这 个 Activity 去 获取 另外 一 个 Fragment 的 实例 ， 
这 样 就 实现 了 不 同 Fragment 之 间 的 通信 功能 。 因 此 ， 这 里 我 们 的 回答 是 肯定 的 。 
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5.3 Fragment 的 生命 周期 


和 Activity 一 样 ，Fragment 也 有 自己 的 生命 周期 ， 并且 它 和 Activity 的 生命 周期 实在 是 太 像 
了 ， 我 相信 你 很 快 就 能 学 会 ， 下 面 我 们 马上 就 来 看 一 下 。 


5.3.1 Fragment 的 状态 和 回调 


还 记得 每 个 Activity 在 其 生命 周期 内 可 能 会 有 哪儿 种 状态 吗 ? 没 错 ， 一 共有 运行 状态 、 暂 停 状 
态 、 停 止 状态 和 销毁 状态 这 4 种 。 类 似 地 ,每 个 Fragment 在 其 生命 周期 内 也 可 能 会 经 历 这 几 种 
状态 ,只 不 过 在 一 些 细小 的 地 方 会 有 部 分 区 别 。 


01. 运行 状态 
当 一 个 Fragment 所 关联 的 Activity 正 处 于 运行 状态 时 ， 该 Fragment 也 处 于 运行 状态 。 
02. 暂停 状态 


当 一 个 Activity 进 入 暂停 状态 时 (由 于 另 一 个 未 占 满 屏幕 的 Activity 被 添加 到 了 栈 顶 ) ， 与 
它 相 关联 的 Fragment 就 会 进入 暂停 状态 。 


03. 停止 状态 


当 一 个 Activity 进 入 停止 状态 时 ， 与 它 相 关联 的 Fragment 就 会 进入 停止 状态 ， 或 者 通过 调 
用 FragmentTransaction 的 remove()、replace() 方 法 将 Fragment 从 Activity 中 移 

除 ， 但 在 事务 提交 之 前 调用 了 addToBackStack() 方 法 ,这 时 的 Fragment 也 会 进入 停止 
状态 。 总 的 来 说 ， 进 入 停止 状态 的 Fragment 对 用 户 来 说 是 完全 不 可 见 的 ， 有 可 能 会 被 系统 
回收 。 


04. 销毁 状态 


Fragment 总 是 依附 于 Activity 而 存在 ,因此 当 Activity 被 销毁 时 ， 与 它 相 关联 的 
Fragment 就 会 进入 销毁 状态 。 或 者 通过 调用 Fragmentiransaction 的 remove( )、 
replace() 方 法 将 Fragment 从 Activity 中 移 除 ，, 但 在 事务 提交 之 前 并 没有 调用 
addToBackStack() 方 法 ,这 时 的 Fragment 也 会 进入 销毁 状态 。 


结合 之 前 的 Activity 状 态 ， 相 信 你 理解 起 来 应 该 党 不 费力 吧 。 同 样 地 ，Fragment 类 中 也 提供 了 
一 系列 的 回调 方法 ， 以 覆盖 它 生 命 周期 的 每 个 环节 。 其 中 ，Activity 中 有 的 回调 方法 ， 
Fragment 中 基本 上 也 有 ,不 过 Fragment 还 提供 了 一 些 附加 的 回调 方法 ， 下 面 我 们 就 重点 看 一 
下 这 几 个 回调 。 


onAttach() : 当 Fragment 和 Activity 建 立 关联 时 调用 。 

onCreateView() : 为 FFragment 创 建 视图 (加 载 布局 ) 时 调用 。 
onActivityCreated() : 确保 与 Fragment 相 关联 的 Activity 已 经 创建 完毕 时 调用 。 
onDestroyView() : 当 与 Fragment 关 联 的 视图 被 移 除 时 调用 。 

onDetach() : 当 Fragment 和 Activity 解 除 关 联 时 调用 。 
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Fragment 完 整 的 生命 周期 可 参考 图 5.7 (图 片 源 自 Android 官 网 ) 。 


添加 一 个 Fragment 


vy 
onAttach() 


vy 
onCreate() 


vy 


onCreateView() < 一 一 一 ~ 


vy 
OnActivityCreated () 


vy 
onStart() 


v 
onResume() 


4 
Fragment 已 激活 


| | 
用 户 点 击 当 Fragment 
返回 键 被 添加 到 
或 Fragment ”返回 栈 ， 然 后 
被 移 除 /替换 。 被 移 除 / 蔡 换 


v vv 
onPause() 
vv vv 
onStop() 
从 返回 栈 中 
vv vv | cy 
onDestroyView!() | 


> 


onDestroy() 


4 


onDetach ( ) 
J 


( Fragment 被 销毁 | 


图 5.7 Fragment 的 生命 周期 


5.3.2 体验 Fragment 的 生命 周期 


为 了 让 你 能 够 更 加 直观 地 体验 Fragment 的 生命 周期 ， 我们 还 是 通过 一 个 例子 来 实践 一 下 。 例 子 
很 简单 ， 仍 然 是 在 FragmentTest 项 目的 基础 上 改动 的 。 


修改 RightFragment 中 的 代码 ， 如 下 所 示 : 
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class RightFragment : Fragment() { 


companion object { 
const val TAG = "RightFragment" 
} 


override fun onAttach(context: Context) { 
super.onAttach (context) 
Log.d(TAG, "onAttach") 

} 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
Log.d(TAG, "onCreate") 

} 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
Log.d(TAG, "onCreateView") 
return inflater.inflate(R.layout.right fragment, container, false) 


} 


override fun onActivityCreated(savedInstanceState: Bundle?) { 
super.onActivityCreated(savedInstanceState) 
Log.d(TAG, "onActivityCreated") 

} 


override fun onStart() { 
super.onStart() 
Log.d(TAG, "onStart") 
} 


override fun onResume() { 
super.onResume() 
Log.d(TAG, "onResume") 
} 


override fun onPause() { 
super.onPause() 
Log.d(TAG, "onPause") 
} 


override fun onStop() { 
super.onStop() 
Log.d(TAG, "onStop") 
} 


override fun onDestroyView() { 
super.onDestroyView() 
Log.d(TAG, "onDestroyView") 
} 


override fun onDestroy() { 
super.onDestroy() 
Log.d(TAG, "onDestroy") 
} 


override fun onDetach() { 
Super.onDetach () 
Log.d(TAG, "onDetach") 
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注意 ,这 里 为 了 方便 日 志 打印 ， 我 们 先 定义 了 一 个 TAG 常量 。Kotlin 中 定义 常量 都 是 使 用 的 这 种 
方式 ,在 companion object、 单 例 类 或 顶层 作用 域 中 使 用 const 关 键 字 声明 一 个 变量 即 可 。 


接 下 来 ， 我 们 在 RightFragment 中 的 每 一 个 回调 方法 里 都 加 入 了 打印 日 志 的 代码 ， 然 后 重新 运 
行程 序 。 这 时 观察 Logcat 中 的 打印 信息 ， 如 图 5.8 所 示 。 


com.example.fragmenttest (12055 v Verbose “ 辟 QrRightFrag 


059/com.example.fragmenttest D/RightFragment: onAttach 
059/com.example.fragmenttest D/RightFragment: onCreate 
059/com.example.fragmenttest D/RightFragment: onCreateView 
059/com.example.fragmenttest D/RightFragment: onActivityCreated 
059/com.example.fragmenttest D/RightFragment: onStart 
059/com.example.fragmenttest D/RightFragment: onResume 


图 5.8 ”启动 程序 时 的 打印 日 志 


可 以 看 到 , 当 RightFragment 第 一 次 被 加 载 到 屏幕 上 时 ，, 会 依次 执行 onAttach ( )、 
onCreate()、onCreateView()、onActivityCreated()、onStart() 和 onResume() 
方法 。 然 后 点 击 LeftFragment 中 的 按钮 ， 此 时 打印 信息 如 图 5.9 所 示 。 


com.example.fragmenttest (12055 地 Verbose vv  Qr-RightFrag 


059/com.example.fragmenttest D/RightFragment: onPause 
059/com.example.fragmenttest D/RightFragment: onStop 
059/com.example,.fragmenttest D/RightFragment: onDestroyView 


图 5.9 ”车 换 成 AnotherRightFragment 时 的 打印 日 志 


由 于 AnotherRightFragment 替 换 了 RightFragment , 此 时 的 RightFragment 进 入 了 停止 状 
态 ,因此 onPause()、onStop() 和 onDestroyView() 方 法 会 得 到 执行 。 当 然 ， 如 果 在 替换 
的 时 候 没 有 调用 addToBackStack() 方 法 ,此 时 的 RightFragment 就 会 进入 销毁 状态 ， 
onDestroy() 和 onDetach() 方 法 就 会 得 到 执行 。 


接着 按 下 Back 键 ，RightFragment 会 重新 加 到 屏幕 ， 打 印信 息 如 图 5.10 所 示 。 


com.example.fragmenttest (12055 Verbose 了  Qr-RightFrag 


959/com,exampLe,fragmenttest D/RightFragment: onCreateView 
259/com.example.fragmenttest D/RightFragment: onActivityCreated 
259/com.example.fragmenttest D/RightFragment: onStart 
259/com.example.fragmenttest D/RightFragment: onResume 


图 5.10 ”返回 RightFragment 时 的 打印 日 志 


由 于 RightFragment 重 新 回 到 了 运行 状态 ,因此 onCreateView()、 
onActivityCreated()、onStart() 和 onResume( ) 方 法 会 得 到 执行 。 注 意 ,此 时 
onCreate( ) 方 法 并 不 会 执行 ， 因 为 我 们 借助 了 addToBackStack ( ) 方 法 使 得 
RightFragment 并 没有 被 销毁 。 


现在 再 次 按 下 Back 键 ， 打印 信息 如 图 5.11 所 示 。 
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com.example.fragmenttest (12055 Verbose “地 Qr RightFrag 


059/com.example.fragmenttest D/RightFragment: onPause 
059/com.example.fragmenttest D/RightFragment: onStop 
059/com.example.fragmenttest D/RightFragment: onDestroyView 
059/com.example.fragmenttest D/RightFragment: onDestroy 
059/com,examptLe,fragmenttest D/RightFragment: onDetach 


图 5.11 退出 程序 时 的 打印 日 志 


依次 执行 onPause()、onStop()、onDestroyView()、onDestroy() 和 onDetach() 方 
法 ， 最 终 将 Fragment 销 毁 。 现 在 ， 你 体验 了 一 遍 Fragment 完 整 的 生命 周期 ， 是 不 是 理解 得 更 
加 深刻 了 ? 


另外 值得 一 提 的 是 ， 在 Fragment 中 你 也 可 以 通过 onSaveInstanceState( ) 方 法 来 保存 数 
据 ， 因 为 进入 停止 状态 的 Fragment 有 可 能 在 系统 内 存 不 足 的 时 候 被 回收 。 保 存 下 来 的 数据 在 
onCreate()、onCreateView() 和 onActivityCreated() 这 3 个 方法 中 你 都 可 以 重新 得 
到 ,它们 都 含有 一 个 Bundle 类 型 的 savedInstanceState 人 参数 。 具 体 的 代码 我 就 不 在 这 里 展 
示 了 ， 如果 你 忘记 了 该 如 何 编写 ， 可 以 参考 3.4.5 小 节 。 
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5.4 动态 加 载 布局 的 技巧 


虽然 动态 添加 Fragment 的 功能 很 强大 ， 可 以 解决 很 多 实际 开发 中 的 问题 ， 但 是 它 毕 竟 只 是 在 一 
个 布局 文件 中 进行 一 些 添加 和 蔡 换 操作 。 如 果 程 序 能 够 根据 设备 的 分 辨 率 或 屏幕 大 小 ， 在 运行 
时 决定 加 载 哪个 布局 ， 那 我 们 可 发 挥 的 空间 就 更 多 了 。 因 此 本 节 我 们 就 来 探讨 一 人 Android 中 动 
态 加 载 布局 的 技巧 。 


5.4.1 使 用 限定 符 


如 果 你 经 常 使 用 平板 ， 应 该 会 发 现 很 多 平板 应 用 采用 的 是 双 页 模式 (程序 会 在 左 侧 的 面板 上 显 
示 一 个 包含 子 项 的 列表 ， 在 右 侧 的 面板 上 显示 内 容 ) ， 因 为 平板 的 屏幕 足够 大 ， 完 全 可 以 同时 
显示 两 页 的 内 容 ， 但 手机 的 屏幕 就 只 能 显示 一 页 的 内 容 ， 因 此 两 个 页 面 需要 分 开 显 示 。 


那么 怎样 才能 在 运行 时 判断 程序 应 该 是 使 用 双 页 模式 还 是 单 页 模式 呢 ? 这 就 需要 借助 限定 符 
(qualifier) 来 实现 了 。 下 面 我 们 通过 一 个 例子 来 学 习 一 下 它 的 用 法 ,修改 FragmentTest 项 目 
中 的 activity_main.xm| 文 件 ， 代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/leftFrag" 
android:name="com.example.fragmenttest.LeftFragment" 
android:layout width="match parent" 
android:layout height="match parent"/> 


</LinearLayout> 


这 里 将 多 余 的 代码 删 掉 ， 只 留 下 一 个 左 侧 Fragment , 并 让 它 充 满 整个 父 布 局 。 接 着 在 res 目 录 
下 新 建 layout-large 文 件 夹 ， 在 这 个 文件 夹 下 新 建 一 个 布局 , 也 叫 作 activity_main.xml ,代码 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/leftFrag" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="0dp" 
android:Layout height="match parent" 
android:Layout weight="1" /> 


<fragment 
android:id="@+id/rightFrag" 
android:name="com.example.fragmenttest.RightFragment" 
android:Layout width="Qdp" 
android:layout height="match parent" 
android:Layout weight="3" /> 


</LinearLayout> 
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可 以 看 到 ,layoutyactivity_main 布 局 只 包含 了 一 个 Fragment , 即 单 页 模式 ， 而 layout- 
large/ activity_ main 布 局 包含 了 两 个 Fragment , 即 双 页 模式 。 其 中 ， Large 就 是 一 个 限定 
符 ， 那些 屏幕 被 认为 是 large 的 设备 就 会 自动 加 载 layout-large 文 件 夹 下 的 布局 ， 小 屏幕 的 设备 
则 还 是 会 加 载 layout 文 件 夹 下 的 布局 。 


然后 将 MainActivity 中 replaceFragment ( ) 方 法 里 的 代码 注释 掉 ， 并 在 平板 模拟 闫 上 重新 运 
行程 序 ， 效果 如 图 5.12 所 示 。 


图 5.12 双 页 模式 运行 效果 
再 启动 一 个 手机 模拟 器 ， 并 重新 运行 程序 ， 效 果 如 图 5.13 所 示 。 
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10:45 


FragmentTest 


BUTTON 


图 5.13 单 页 模式 运行 效果 

这 样 我 们 就 实现 了 在 程序 运行 时 动态 加 载 布局 的 功能 。 
Android 中 一 些 常 见 的 限定 符 可 以 如 表 5.1 所 示 。 

表 5.1 Android 中 常见 的 限定 符 


屏幕 特征 限定 符 描述 

small 提供 给 小 屏幕 设备 的 资源 
normal 提供 给 中 等 屏幕 设备 的 资源 

6 large | 提供 给 大 屏幕 设备 的 资源 
xlarge 提供 给 超大 屏幕 设备 的 资源 

分 辩 率 ldpi 是 供给 低 分 辨 率 设 备 的 资源 (120 dpi 以 下 ) 
mdpi 提供 给 中 等 分 辨 率 设备 的 资源 (120 dpi~160 dpi) 
hdpi 是 供给 高 分 辩 率 设备 的 资源 (160 dpi~240 dpi) 
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xhdpi 提供 给 超 高 分 辨 率 设 备 的 资源 (240 dpi~320 dpi) 

xxhdpi 提供 给 超 超 高 分 辨 率 设 备 的 资源 (320 dpi~480 dpi) 
land 提供 给 横 屏 设备 的 资源 
port 提供 给 竖 屏 设备 的 资源 


方向 


5.4.2 使 用 最 小 宽度 限定 符 


在 上 一 小 节 中 我 们 使 用 Large 限 定 符 成 功 解决 了 单 页 双 页 的 判断 问题 ， 不 过 很 快 又 有 一 个 新 的 
问题 出 现 了 : large 到 底 是 指 多 大 呢 ? 有 时 候 我 们 希望 可 以 更 加 灵活 地 为 不 同 设备 加 载 布 局 , 不 
管 它们 是 不 是 被 系统 认定 为 large， 这 时 就 可 以 使 用 最 小 宽度 限定 符 (smallest-width 
qualifier) 。 


最 小 宽度 限定 符 允 许 我 们 对 屏幕 的 宽度 指定 一 个 最 小 值 (以 dp 为 单位 ) ， 然 后 以 这 个 最 小 值 为 
临界 点 ， 屏 幕 宽度 大 于 这 个 值 的 设备 就 加 载 一 个 布局 ， 屏 幕 宽 度 小 于 这 个 值 的 设备 就 加 载 另 一 
个 布局 。 


在 res 目 录 下 新 建 layout-sw600dp 文 件 夹 ， 然 后 在 这 个 文件 夹 下 新 建 activity_main.xml 布 
局 ， 代 码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/leftFrag" 
android:name="com.example.fragmenttest.LeftFragment" 
android:Layout width="Qdp" 
android:layout height="match parent" 
android:layout weight="1" /> 


<fragment 
android:id="@+id/rightFrag" 
android:name="com.example.fragmenttest.RightFragment" 
android:Layout width="Qdp" 
android:layout height="match parent" 
android:Layout weight="3" /> 


</LinearLayout> 


这 就 意味 着 ， 当 程序 运行 在 屏幕 宽度 大 于 等 于 600 dp 的 设备 上 时 ， 会 加 载 layout- 
sw600dpy/activity_main 布 局 , 当 程 序 运行 在 屏幕 宽度 小 于 600 dp 的 设备 上 时 ， 则 仍然 加 载 
默认 的 layouty/activity main 布局 。 
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5.5 Fragment 的 最 佳 实践 : 一 个 简易 版 的 新 闻 应 用 


现在 你 已 经 将 关于 Fragment 的 重要 知识 点 掌握 得 差不多 了 ， 不 过 在 灵活 运用 方面 可 能 还 有 些 欠 
缺 ， 因 此 下 面 该 进入 我 们 本 章 的 最 佳 实践 环节 了 。 


前 面 提 到 过 ，Fragment 很 多 时 候 是 在 平板 开发 当中 使 用 的 ， 因 为 它 可 以 解决 屏幕 空间 不 能 充分 
利用 的 问题 。 那 是 不 是 就 表明 ， 我们 开发 的 程序 都 需要 提供 一 个 手机 版 和 一 个 平板 版 呢 ? 确实 
有 不 少 公司 是 这 么 做 的 ， 但 是 这 样 会 耗费 很 多 的 人 力 物 力 财力 。 因 为 维护 两 个 版 本 的 代码 成 本 
很 高 : 每 当 增加 新 功能 时 ， 需 要 在 两 份 代 码 里 各 写 一 遍 ; 每 当 发 现 一 个 Dug 时 ， 需 要 在 两 份 代码 
里 各 修改 一 次 。 因 此 ， 今 天 我 们 最 佳 实践 的 内 容 就 是 教 你 如 何 编写 兼容 手机 和 平板 的 应 用 程 

序 。 


还 记得 我 们 在 本 章 开始 的 时 候 提 到 的 一 个 新 闻 应 用 吗 ? 现在 我 们 就 运用 本 章 所 学 的 知识 来 编写 
一 个 简易 版 的 新 闻 应 用 ， 并 且 要 求 它 可 以 兼容 手机 和 平板 。 新 建 好 一 个 
FragmentBestPractice 项 目 ， 然 后 开始 动手 吧 ! 


由 于 待 会 在 编写 新 闻 列 表 时 会 使 用 到 RecyclerView ,因此 首先 需要 在 app/build.gradle 当 中 添 
加 依赖 库 ， 如 下 所 示 : 


dependencies { 
impLementation fileTree(dir: 'libs', include: ['*.jar']) 
implementation"org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin version" 
implementation 'androidx.appcompat:appcompat:1.0.2" 
implementation 'androidx.core:core-ktx:1.0.2" 
implementation 'androidx.recyclerview:recyclerview:1.0.0' 
implementation 'androidx.constraintlayout:constraintlayout:1.1.3" 
testImpLementation ' junit:junit:4.12， 
androidTestImpLementation "androidx.test:runner':1.1.1' 
androidTestImpLementation 'androidx.test.espresso:espresso-core:3.1.1' 


} 


接 下 来 我 们 要 准备 好 一 个 新 闻 的 实体 类 ， 新 建 类 News， 代 码 如 下 所 示 : 


class News(val title: String, val content: String) 


News 类 的 代码 非常 简单 ，title 字 上段 表 示 新 闻 标 题 ，content 字 段 表 示 新 闻 内 容 。 接 着 新 建 布 
局 文件 news_content frag.xml , 作为 新 闻 内 容 的 布局 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<LinearLayout 
android:id="@+id/contentLayout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" 
android:visibility="invisible" > 


<TextView 
android:id="@+id/newsTitle" 
android:layout width="match parent" 
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android:Layout height="wrap content" 
android:gravity="center" 
android:padding="10dp" 
android:textSize="20sp" /> 


<View 
android:layout width="match parent" 
android:layout height="1ldp" 
android:background="#000" /> 


<TextView 
android:id="@+id/newsContent" 
android:layout width="match parent" 
android:layout height="0Qdp" 
android:layout weight="1" 
android:padding="15dp" 
android:textSize="18sp" /> 


</LinearLayout> 


<View 
android:Layout width="1dp" 
android:Layout height="match parent" 
android:Layout alignParentLeft="true" 
android:background="#000" /> 


</RelativeLayout> 


新 闻 内 容 的 布局 主要 可 以 分 为 两 个 部 分 : 头 部 部 分 显示 新 闻 标题 ， 正 文部 分 显示 新 闻 内 容 ， 中 
间 使 用 一 条 水 平方 向 的 细 线 分 隔 开 。 除 此 之 外 ， 这 里 还 使 用 了 一 条 垂直 方向 的 细 线 , 它 的 作用 
是 在 双 页 模式 时 将 左 侧 的 新 闻 列 表 和 右 侧 的 新 闻 内 容 分 隔 开 。 细 线 是 利用 View 来 实现 的 ， 将 
View 的 宽 或 高 设置 为 1 dp， 再 通过 background 属 性 给 细 线 设置 一 下 颜色 就 可 以 了 ， 这 里 我 们 
把 细 线 设置 成 黑色 。 


另外 ,我 们 还 要 将 新 闻 内 容 的 布局 设置 成 不 可 见 。 因 为 在 双 页 模式 下 ， 如 果 还 没有 选中 新 闻 列 
表 中 的 任何 一 条 新 闻 ， 是 不 应 该 显示 新 闻 内 容 布局 的 。 


接 下 来 新 建 一 个 NewsContentFragment 类 ， 继 承 自 Fragment , 代码 如 下 所 示 : 


class NewsContentFragment : Fragment() { 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
return inflater.inflate(R.layout.news content frag, container, false) 


} 


fun refresh(title: String, content: String) { 
contentLayout.visibility = View.VISIBLE 
newsTitle.text = title // 刷新 新 闻 的 标题 
newsContent ,text = content // 刷新 新 闻 的 内 容 


} 


这 里 首先 在 onCreateView( ) 方 法 中 加 载 了 我 们 刚刚 创建 的 News_content frag 布 局 , 这 个 没 
什么 好 解释 的 。 接 下 来 又 提供 了 一 个 ref resh ( ) 方 法 ,用 于 将 新 闻 的 标题 和 内 容 显示 在 我 们 刚 
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刚 定 义 的 界面 上 上。 注意 ， 当 调用 了 ref resh ( ) 方 法 时 ， 需 要 将 我 们 刚才 隐藏 的 新 闻 内 容 布局 设 
置 成 可 见 。 


这 样 我 们 就 把 新 闻 内 容 的 Fragment 和 布局 都 创建 好 了 ， 但 是 它们 都 是 在 双 页 模式 中 使 用 的 ， 如 
果 想 在 单 页 模式 中 使 用 的 话 ， 我 们 还 需要 再 创建 一 个 Activity。 碳 击 
com.example.fragmentbestpractice 包 >NewActivityEmpty Activity， 新建 一 个 
NewsContentActivity ,布局 名 就 使 用 默认 的 activity_news_content 即 可 。 然 后 修改 
activity_news_content.xml 中 的 代码 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/newsContentFrag" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 


</LinearLayout> 


这 里 我 们 充分 发 挥 了 代码 的 复 用 性 ， 直 接 在 布局 中 引入 了 NewsContentFragment。 这 样 相 当 
于 把 news_content frag 布 局 的 内 容 自 动 加 了 进来 。 


然后 修改 NewsContentActivity 中 的 代码 ， 如 下 所 示 : 


class NewsContentActivity : AppCompatActivity() { 


companion object { 
fun actionStart(context: Context, title: String, content: String) { 
val intent = Intent(context, NewsContentActivity::class.java).apply { 
putExtra("news title", title) 
putExtra("news content", content) 


context.startActivity(intent) 


} 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity news content) 
val title = intent.getStringExtra("news title") // 获取 传 入 的 新 闻 标 题 
val content = intent.getStringExtra("news content") // 获取 传 入 的 新 闻 内 容 
if (title != null &é& content != null) { 
val fragment = newsContentFrag as NewsContentFragment 
fragment.refresh(title, content) // 刷 新 MewsContentFragment 界 面 


} 


可 以 看 到 , 在 onCreate () 方 法 中 我 们 通过 Intent 获 取 到 了 传 入 的 新 闻 标 题 和 新 闻 内 容 ， 然 后 
使 用 kotlin-android-extensions 插 件 提供 的 简洁 写法 得 到 了 NewsContentFragment 的 实 
例 ， 接 着 调用 它 的 ref resh ( ) 方 法 ， 将 新 闻 的 标题 和 内 容 传 入 ,就 可 以 把 这 些 数据 显示 出 来 


www.blogss.cn 


了 。 注 意 , 这 里 我 们 还 提供 了 一 个 actionStart() 方 法 ,还 记得 它 的 作用 吗 ? 如 果 忘 记 的 话 就 
再 去 阅读 一 遍 3.6.3 小 节 吧 。 


接 下 来 还 需要 再 创建 一 个 用 于 显示 新 闻 列 表 的 布局 ， 新 建 news title_frag.xml , 代码 如 下 所 
小 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/newsTitleRecyclerView" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 


</LinearLayout> 


这 个 布局 的 代码 就 非常 简单 了 ， 里 面 只 有 一 个 用 于 显示 新 闻 列 表 的 RecyclerView。 既 然 要 用 到 
RecyclerView ,那么 就 必定 少不了 子 项 的 布局 。 新 建 news_item.xml 作 为 RecyclerView 子 项 
的 布局 ， 代 码 如 下 所 示 : 


<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/newsTitle" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:maxLines="1" 
android:ellipsize="end" 
android:textSize="18sp" 
android:paddingLeft="10dp" 
android:paddingRight="10dp" 
android:paddingTop="15dp" 
android:paddingBottom="15dp” /> 


子 项 的 布局 也 非常 简单 ， 只 有 一 个 TextView。 仔 细 观 察 TextView ， 你 会 发 现 其 中 有 几 个 属性 是 
我 们 之 前 没有 学 过 的 : android:padding 表 示 给 控件 的 周围 加 上 补 白 ， 这 样 不 至 于 让 文本 内 
容 紧 靠 在 边缘 上 ; android:maxLines 设 置 为 1] 表示 让 这 个 TextView 只 能 单行 显示 ; 
android:eLLipsize 用 于 设 定 当 文本 内 容 超出 控件 宽度 时 文本 的 缩 略 方式 ， 这 里 指定 成 end 
表示 在 尾部 进行 缩 略 。 


既然 新 闻 列 表 和 子 项 的 布局 都 已 经 创建 好 了 ， 那么 接 下 来 我 们 就 需要 一 个 用 于 展示 新 闻 列 表 的 
地 方 。 这 里 新 建 NewsTitleFragment 作 为 展示 新 闻 列 表 的 Fragment , 代码 如 下 所 示 : 


class NewsTitleFragment : Fragment() { 
private var isTwoPane = false 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
return inflater.inflate(R.layout.news title frag, container, false) 


override fun onActivityCreated(savedInstanceState: Bundle?) { 
super.onActivityCreated(savedInstanceState) 
isTwoPane = activity?.findViewById<View>(R.id.newsContentLayout) != null 
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} 


可 以 看 到 ，NewsTitleFragment 中 并 没有 多 少 代 码 ， 在 onCreateView( ) 方 法 中 加 载 了 
news _title_frag 布 局 ,这 个 没什么 好 说 的 。 我 们 注意 看 一 下 onActivityCreated() 方 法 ， 
这 个 方法 通过 在 Activity 中 能 否 找到 一 个 id 为 newsContentLayout 的 View , 来 判断 当前 是 双 
页 模式 还 是 单 页 模式 ， 因 此 我 们 需要 让 这 个 id 为 newsContentLayout 的 View 只 在 双 页 模式 中 
才 会 出 现 。 注 意 ， 由 于 在 Fragment 中 调用 getActivity() 方 法 有 可 能 返回 nuLL , 所 以 在 上 
述 代 码 中 我 们 使 用 了 一 个 ? .操作 符 来 保证 代码 的 安全 性 。 


那么 怎样 才能 实现 让 id 为 newsContentLayout 的 View 只 在 双 页 模式 中 才 会 出 现 呢 ? 其 实 并 不 
复杂 ， 只 需要 借助 我 们 刚刚 学 过 的 限定 符 就 可 以 了 。 首 先 修改 activity_main.xml 中 的 代码 ， 如 
下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/newsTitleLayout" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/newsTitleFrag" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:layout width="match parent" 
android:layout height="match parent" 
/> 


</FrameLayout> 


上 述 代 码 表 示 在 单 页 模式 下 只 会 加 载 一 个 新 闻 标 题 的 Fragment。 


然后 新 建 layout-sw600dp 文 件 夹 ， 在 这 个 文件 夹 下 再 新 建 一 个 activity_main.xml 文 件 ， 代码 
如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="match parent" > 


<fragment 
android:id="@+id/newsTitleFrag" 
android:name="com.example.fragmentbestpractice.NewsTitleFragment" 
android:Layout width="0dp" 
android:Layout height="match parent" 
android:Layout weight="1" /> 


<FrameLayout 
android:id="@+id/newsContentLayout" 
android:Layout width="0dp" 
android:Layout height="match parent" 
android:Layout weight="3" > 


<fragment 
android:id="@+id/newsContentFrag" 
android:name="com.example.fragmentbestpractice.NewsContentFragment" 
android:layout width="match parent" 
android:layout height="match parent" /> 
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</FrameLayout> 


</LinearLayout> 


可 以 看 出 ， 在 双 页 模式 下 ,我 们 同时 引入 了 两 个 Fragment， 并 将 新 闻 内 容 的 Fragment 放 在 了 
一 个 FrameLayout 布 局 下 ， 而 这 个 布局 的 id 正 是 newsContentLayout。 因 此 ,能 够 找到 这 个 
id 的 时 候 就 是 双 页 模式 ， 人 否则 就 是 单 页 模式 。 


现在 我 们 已 经 将 绝 大 部 分 的 工作 完成 了 ， 但 还 剩 下 至 关 重 要 的 一 点 ， 就 是 在 
NewsTitleFragment 中 通过 RecyclerView 将 新 闻 列 表 展 示 出 来 。 我 们 在 NewsTitleFragment 
中 新 建 一 个 内 部 类 NewsAdapter 来 作为 RecyclerView 的 适配器 ， 如 下 所 示 : 


class NewsTitleFragment : Fragment() { 


private var isTwoPane = false 


inner class NewsAdapter(val newsList: List<News>) 
RecyclerView.Adapter<NewsAdapter.ViewHolder>() { 


inner class ViewHolder(view: View) : RecyclerView.ViewHolder(view) { 
val newsTitle: TextView = view.findViewById(R.id.newsTitle) 
} 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context) 
.inflate(R.layout.news item, parent, false) 
val holder = ViewHolder(view) 
holder.itemView.setOnClickListener { 
val news = newsList[holder.adapterPosition] 
if (isTwoPane) { 
// 如 果 是 双 页 模式 ， 则 刷新 NewsContentFragment 中 的 内 容 
val fragment = newsContentFrag as NewsContentFragment 
fragment . refresh(news .titLe，news.content ) 
} else { 
// 如 果 是 单 页 模式 ， 则 直接 启动 NewsContentActivity 
NewsContentActivity.actionStart(parent.context, news.title, 
news .content) 


} 


return holder 


override fun onBindViewHolder(holder: ViewHolder, position: Int) { 
val news = newsList[position] 
holder.newsTitle.text = news.title 


} 


override fun getItemCount() = newsList.size 


} 


RecyclerView 的 用 法 你 已 经 相当 熟悉 了 ， 因此 这 个 适配器 的 代码 对 你 来 说 应 该 没有 什么 难度 
吧 ? 需要 注意 的 是 ,之 前 我 们 都 是 将 适配器 写成 一 个 独立 的 类 ,其实 也 可 以 写成 内 部 类 。 这 里 
写成 内 部 类 的 好 处 就 是 可 以 直接 访问 NewsTitleFragment 的 变量 ,比如 isTwoPane，。 
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观察 一 下 onCreateViewHolder() 方 法 中 注册 的 点 击 事件 ,首先 获取 了 点 击 项 的 News 实 例 ， 
然后 通过 isTwoPane 变 量 判断 当前 是 单 页 还 是 双 页 模式 。 如 果 是 单 页 模式 ， 就 启动 一 个 新 的 
Activity 去 显示 新 闻 内 容 ; 如 果 是 双 页 模式 ， 就 更 新 NewsContentFragment 里 的 数据 。 


现在 还 剩 最 后 一 步 收 尾 工 作 ， 就 是 向 RecyclerView 中 填充 数据 了 。 修 改 NewsTitleFragment 
中 的 代码 ， 如 下 所 示 : 


class NewsTitleFragment : Fragment() { 


override fun onActivityCreated(savedInstanceState: Bundle?) { 
super.onActivityCreated(savedInstanceState) 
isTwoPane = activity?.findViewById<View>(R.id.newsContentLayout) != null 
val layoutManager = LinearLayoutManager(activity) 
newsTitleRecyclerView.layoutManager = layoutManager 
val adapter = NewsAdapter (getNews()) 
newsTitleRecyclerView.adapter = adapter 


} 


private fun getNews(): List<News> { 
val newsList = ArrayList<News>() 
for (i in 1..50) { 
val news = News("This is news title $i", getRandomLengthString("This is news 
content $i. ")) 
newsList.add(news) 
} 
return newsList 


} 


private fun getRandomLengthString(str: String): String { 
val n = (1..20).random() 
val builder = StringBuilder() 
repeat(n) { 
builder.append(str) 
} 


return builder.toString() 


} 


可 以 看 到 ,onActivityCreated () 方 法 中 添加 了 RecyclerView 标 准 的 使 用 方法 。 在 
Fragment 中 使 用 RecyclerView 和 在 Activity 中 使 用 几乎 是 一 模 一 样 的 ， 相 信 没 有 什么 需要 解 
释 的 。 另 外 ， 这 里 调用 了 getNews ( ) 方 法 来 初始 化 50 条 模拟 新 闻 数 据 ， 同样 使 用 了 一 个 
getRandomLengthString() 方 法 来 随机 生成 新 闻 内 容 的 长 度 ， 以 保证 每 条 新 闻 的 内 容 差距 比 
较 大 ， 相 信 你 对 这 个 方法 肯定 不 会 陌生 了 。 


这 样 我们 所 有 的 编码 工作 就 已 经 完成 了 ， 赶快 来 运行 一 下 吧 ! 首先 在 手机 模拟 器 上 运行 ， 效 果 
如 图 5.14 所 示 。 
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This is news title 10 


This is news title 11 


图 5.14 单 页 模式 的 新 闻 列 表 界 面 


可 以 看 到 许多 条 新 闻 的 标题 ， 然 后 点 击 第 一 条 新 闻 ， 会 局 动 一 个 新 的 Activity 来 显示 新 闻 的 内 
容 , 效果 如 图 5.15 所 示 。 
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This is news content 1. This is news content 1 
This is news content 1. This is news content 1 
This is news content 1. This is news content 1 
This is news 1. This is news content 1 


图 5.15 单 页 模式 的 新 闻 内 容 界面 
接 下 来 将 程序 在 平板 模拟 器 上 运行 ， 同 样 点 击 第 一 条 新 闻 ， 效果 如 图 5.16 所 示 。 
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FragmentBestPractice 


This is news title 14 
图 5.16 双 页 模式 的 新 闻 标题 和 内 容 界 面 


怎么 样 ? 同样 的 一 份 代 码 ， 在 手机 和 平板 上 运行 却 得 到 两 种 完全 不 同 的 效果 ， 这 说 明 我 们 程序 
的 兼容 性 已 经 相当 不 错 了 。 通 过 这 个 例子 ， 我 相信 你 对 Fragment 的 理解 一 定 又 加 深 了 许多 。 那 
么 关于 Fragment 的 知识 就 先 学 到 这 里 ， 现 在 让 我 们 进入 本 章 的 Kotlin 课 堂 。 
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5.6 ”Kotlin 课 堂 : 扩展 函数 和 运算 符 重 载 


很 开心 ， 又 要 开始 学 习 Kotlin 的 新 知识 了 。 通 过 前 面 几 章 内 容 的 锻炼 ， 相 信 现 在 的 你 已 经 可 以 颇 
为 熟练 地 使 用 Kotlin 来 编写 代码 了 。 现 在 是 时 候 去 探究 一 些 Kotlin 更 加 深入 的 内 容 了 ,那么 赶快 
进入 本 章 的 Kotlin 课 堂 当 中 吧 。 


5.6.1 大 有 用 途 的 扩展 函数 


不 少 现代 高 级 编程 语言 中 有 扩展 函数 这 个 概念 ，java 却 一 直 以 来 都 不 支持 这 个 非常 有 用 的 功 

能 ,这 多 少 会 让 人 有 些 遗 憾 。 但 值得 高 兴 的 是 ，Kotlin 对 扩展 函数 进行 了 很 好 的 支持 ， 因 此 这 个 
知识 点 是 我 们 无 论 如 何 都 不 能 错过 的 。 

首先 看 一 下 什么 是 扩展 溺 数 。 扩 展 消 数 表示 即使 在 不 修改 某 个 类 的 源码 的 情况 下 ， 仍然 可 以 打 
开 这 个 类 ， 向 该 类 添加 新 的 函数 。 


为 了 帮助 你 更 好 地 理解 ， 我 们 先 来 思考 一 个 功能 。 一 段 字 符 串 中 可 能 包含 字母 、 数 字 和 特殊 符 
号 等 字符 ， 现 在 我 们 希望 统计 字符 串 中 字母 的 数量 ， 你 要 怎么 实现 这 个 功能 呢 ? 如 果 按 照 一 般 
的 编程 思维 ， 可 能 大 多 数 人 会 很 自然 地 写 出 如 下 驮 数 : 


object StringUtil { 


fun lettersCount(str: String): Int { 
var count = 0 
for (char in str) { 
if (char.isLetter()) { 
COUuNt++ 


return count 


} 


} 


这 里 先 定义 了 一 个 StringUtil 单 例 类 ,然后 在 这 个 单 例 类 中 定义 了 一 个 LettersCount() 活 
数 ， 该 函数 接收 一 个 字符 串 参 数 。 在 LettersCount ( ) 方 法 中 ， 我 们 使 用 for- in 循环 去 遍历 

字符 串 中 的 每 一 个 字符 。 如 果 该 字符 是 一 个 字母 的 话 ， 那 么 就 将 计数 器 加 1 ,最 终 返回 计数 器 的 
值 。 


现在 ， 当 我 们 需要 统计 某 个 字符 串 中 的 字母 数量 时 ， 只 需要 编写 如 下 代码 即 可 : 


val Str = "ABC123xyz!@#" 
val count = StringUtil.lettersCount(str) 


这 种 写法 绝对 可 以 正常 工作 ， 并 且 这 也 是 Java 编程 中 最 标准 的 实现 思维 。 但 是 有 了 扩展 函数 之 
后 就 不 一 样 了 ， 我 们 可 以 使 用 一 种 更 加 面向 对 象 的 思维 来 实现 这 个 功能 ， 比 如 说 将 
LettersCount ( ) 基 数 添加 到 St ring 类 当中 。 


下 面 我 们 先 来 学 习 一 下 定义 扩展 函数 的 语法 结构 ， 其 实 非常 简单 ， 如 下 所 示 : 
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fun ClassName.methodName(paraml: Int, param2: Int): Int { 
return 0 


} 


相 比 于 定义 一 个 普通 的 函数 ， 定 义 扩展 函数 只 需要 在 函数 名 的 前 面 加 上 一 个 CLassName .的 语 
法 结构 ， 就 表示 将 该 函数 添加 到 指定 类 当中 了 ，。 

了 解 了 定义 扩展 函数 的 语法 结构 ， 接 下 来 我 们 就 尝试 使 用 扩展 函数 的 方式 来 优化 刚才 的 统计 功 
能 。 

由 于 我 们 希望 向 String 类 中 添加 一 个 扩展 函数 ， 因 此 需要 先 创建 一 个 String.kt 文 件 。 文 件 名 虽 
然 并 没有 固定 的 要 求 ， 但 是 我 建议 向 哪个 类 中 添加 扩展 函数 ， 就 定义 一 个 同名 的 Kotlin 文 件 ， 这 
样 便于 你 以 后 查找 。 当 然 ， 扩 展 函数 也 是 可 以 定义 在 任何 一 个 现 有 类 当中 的 ， 并 不 一 定 非 要 创 
建新 文件 。 不 过 通常 来 说 , 最 好 将 它 定 义 成 顶层 方法 ， 这样 可 以 让 扩展 函数 拥有 全 局 的 访问 

域 。 


现在 在 String.kt 文 件 中 编写 如 下 代码 : 


fun String.lettersCount(): Int { 
var count = 0 
for (char in this) { 
if (char.isLetter()) { 
Count++ 


} 


return count 


} 


注意 这 里 的 代码 变化 ， 现 在 我 们 将 LettersCount ( ) 方 法 定义 成 了 String 类 的 扩展 函数 , 那 
么 函数 中 就 自动 拥有 了 St ring 实 例 的 上 下 文 。 因 此 LettersCount ( ) 函数 就 不 再 需要 接收 一 
个 字符 串 参数 了 ， 而 是 直接 遍历 this 即 可 ,因为 现在 this 就 代表 着 字符 串 本 身 。 


定义 好 了 扩展 函数 之 后 ， 统 计 某 个 字符 串 中 的 字母 数量 只 需要 这 样 写 即 可 : 


val count = "ABC123xyz!@#".lettersCount() 


是 不 是 很 神奇 ? 看 上 去 就 好 像 是 St ring 类 中 自 带 了 LettersCount ( ) 方 法 一 样 。 


扩展 函数 在 很 多 情况 下 可 以 让 APl 变 得 更 加 简洁 、 丰 语 ,更 加 面向 对 象 。 我 们 再 次 以 String 类 
为 例 ， 这 是 一 个 finalL 类 , 任何 一 个 类 都 不 可 以 继承 它 ， 也 就 是 说 它 的 API 只 有 固定 的 那些 而 
已 ， 至 少 在 java 中 就 是 如 此 。 然 而 到 了 Kotlin 中 就 不 一 样 了 ， 我 们 可 以 向 St ring 类 中 扩展 任何 
项 数 ,使 它 的 API 变 得 更 加 丰富 。 比 如 ，, 你 会 发 现 Kotlin 中 的 String 甚 至 还 有 reverse( ) 函 数 
用 于 反 转 字符 串 ，capitaLize() 函 数 用 于 对 首 字母 进行 大 写 ， 等 等 ， 这 都 是 Kotlin 语 言 自 带 
的 一 些 扩展 函数 。 这 个 特性 使 我 们 的 编程 工作 可 以 变 得 更 加 简便 。 


另外 ,不 要 被 本 节 的 示例 内 容 所 局 限 ， 除 了 String 类 之 外 ,你 还 可 以 向 任何 类 中 添加 扩展 函 


数 ，Kotlin 对 此 基本 没有 限制 。 如 果 你 能 利用 好 扩展 函数 这 个 功能 ， 将 会 大 幅度 地 提升 你 的 代码 
质量 和 开发 效率 。 
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5.6.2 有趣 的 运算 符 重 载 


运算 符 重 载 是 Kotlin 提 供 的 一 个 比较 有 趣 的 语法 糖 。 我 们 知道 ，Java 中 有 许多 语言 内 管 的 运算 符 
关键 字 ,如 + - * / % ++ --。 而 Kotlin 允 许 我 们 将 所 有 的 运算 符 甚至 其 他 的 关键 字 进 行 重 
载 ， 从 而 拓展 这 些 运算 符 和 关键 字 的 用 法 。 


本 小 节 的 内 容 相 比 于 之 前 所 学 的 Kotlin 知 识 会 相对 复杂 一 些 ， 但 是 我 向 你 保证 ， 这 是 一 节 非 常 有 
趣 的 内 容 ， 掌 握 之 后 你 一 定 会 受益 良 多 。 


我 们 先 来 回顾 一 下 运算 符 的 基本 用 法 。 相 信 每 个 人 都 使 用 过 加 减 乘 除 这 种 四 则 运算 符 。 在 编程 
语言 里 面 ， 两 个 数字 相 加 表示 求 这 两 个 数字 之 和 ， 两 个 字符 串 相 加 表示 对 这 两 个 字符 串 进行 拼 
接 , 这 种 基本 用 法 相信 接触 过 编程 的 人 都 明白 。 但 是 Kotlin 的 运算 符 重 载 却 允 许 我 们 让 任意 两 个 
对 象 进行 相 加 ， 或 者 是 进行 更 多 其 他 的 运算 操作 。 


当然 ， 虽 然 Kotlin 赋 予 了 我 们 这 种 能 力 ， 在 实际 编程 的 时 候 也 要 考虑 逻辑 的 合理 性 。 比 如 说 ， 让 
两 个 Student 对 象 相 加 好 像 并 没有 什么 意义 ,但 是 让 两 个 Honey 对 象 相 加 就 变 得 有 意义 了 ， 
为 钱 是 可 以 相 加 的 。 

那么 接 下 来 ， 我 们 首先 学 习 一 下 运算 符 重 载 的 基本 语法 ， 然 后 再 来 实现 让 两 个 Money 对 象 相 加 
的 功能 。 

运算 符 重 载 使 用 的 是 operator 关 键 字 ， 只 要 在 指定 函数 的 前 面 加 上 operator 关 键 字 ， 就 可 以 
实现 运算 符 重 载 的 功能 了 。 但 问题 在 于 这 个 指定 函数 是 什么 ? 这 是 运算 符 重 载 里 面 比较 复杂 的 
一 个 问题 ， 因 为 不 同 的 运算 符 对 应 的 重 载 函数 也 是 不 同 的 。 比 如 说 加 号 运算 符 对 应 的 是 plus ( ) 
函数 , 减 号 运算 符 对 应 的 是 ninus ( ) 函数 。 


我 们 这 里 还 是 以 加 号 运算 符 为 例 ， 如果 想 要 实现 让 两 个 对 象 相 加 的 功能 ， 那么 它 的 语法 结构 如 
下 : 


class 0bj { 


operator fun plus(obj: 0bj): 0bj { 
// 处 理 相 加 的 逻辑 
} 


} 


在 上 述 语 法 结构 中 ， 关 键 字 operator 和 拯 数 名 plus 都 是 固定 不 变 的 ， 而 接收 的 参数 和 函数 返 
回 值 可 以 根据 你 的 逻辑 自行 设 定 。 那 么 上 述 代码 就 表示 一 个 0bj 对象 可 以 与 男 一 个 0bj 对 象 相 
加 ， 最终 返回 一 个 新 的 0bj 对 象 。 对 应 的 调用 方式 如 下 : 


val objl = 0bj() 
val obj2 = 0bj() 
val obj3 = objl1 + obj2 


这 种 0bj1 + 0bj2 的 语法 看 上 去 好 像 很 神奇 ， 但 其 实 这 就 是 Kotlin 给 我 们 提供 的 一 种 语法 糖 ， 
已 会 在 编译 的 时 候 被 转换 成 obj1.pLus (0bj2) 的 调用 方式 。 
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了 解 了 运算 符 重 载 的 基本 语法 之 后 ， 下 面 我 们 开始 实现 一 个 更 加 有 意义 功能 : 让 两 个 Money 对 
象 相 加 。 


首先 定义 Money 类 的 结构 , 这 里 我 准备 让 Money 的 主 构造 函数 接收 一 个 vaLue 参 数 ， 用 于 表示 
钱 的 金额 。 创 建 Money .kt 文件 ,代码 如 下 所 示 : 


class Money(val value: Int) 


定义 好 了 Money 类 的 结构 ， 接 下 来 我 们 就 使 用 运算 符 重 载 来 实现 让 两 个 Money 对 象 相 加 的 功 


能 : 
class Money(val value: Int) { 


operator fun plus(money: Money): Money { 
val sum = value + money.value 
return Money(sum) 


} 


} 


可 以 看 到 ,这 里 使 用 了 operator 关 键 字 来 修饰 pLus ( ) 函数 ， 这 是 必 不 可 少 的 。 在 plus( ) 函 
数 中 ， 我们 将 当前 Money 对 象 的 vaLue 和 参数 传 入 的 Money 对 象 的 vaLue 相 加 ， 然 后 将 得 到 的 
和 传 给 一 个 新 的 Money 对 象 并 将 该 对 象 返回 。 这 样 两 个 Money 对 象 就 可 以 相 加 了 ,就 是 这 么 简 


o 


现在 我 们 可 以 使 用 如 下 代码 来 对 刚刚 编写 的 功能 进行 测试 : 


val moneyl 


= Money(5) 
val money2 = Money(10) 


val money3 = moneyl + money2 
println(money3.value) 


最 终 打印 的 结果 一 定 是 15， 你 可 以 自己 验证 一 下 。 


但 是 ,Money 对 象 只 允许 和 另 一 个 Money 对 象 相 加 ， 有 没有 觉得 这 样 不 够 方便 呢 ? 或 许 你 会 觉 
得 ， 如果 Money 对 象 能 够 直接 和 数字 相 加 的 话 ， 就 更 好 了 。 这 个 功能 当然 也 是 可 以 实现 的 ， 
为 Kotlin 允 许 我 们 对 同一 个 运算 符 进行 多 重重 载 ， 代 码 如 下 所 示 : 


class Money(val value: Int) { 


operator fun plus(money: Money): Money { 
val sum = value + money.value 
return Money(sum) 


} 


operator fun plus(newValue: Int): Money { 
val sum = value + newValue 
return Money(sum) 


} 
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这 里 我 们 又 重 载 了 一 个 pLus ( ) 函数 ， 不 过 这 次 接收 的 参数 是 一 个 整 型 数字 ， 其 他 代码 基本 是 一 
样 的 。 


那么 现在 ，Money 对 象 就 拥有 了 和 数字 相 加 的 能 


val moneyl = Money(5) 

val money2 Money (10) 

val money3 = moneyl + money2 
val money4 = money3 + 20 
println(money4.value) 


这 里 让 money3 对 象 再 加 上 20 的 金额 ， 最终 打印 的 结果 就 变 成 了 35。 


当然 ,你 还 可 以 对 这 个 例子 进一步 扩展 ， 比 如 加 上 汇率 转换 的 功能 。 让 1 人 民 币 的 Money 对 象 和 
1 美元 的 Money 对 象 相 加 ， 然 后 根据 实时 汇率 进行 转换 ， 从 而 返回 一 个 新 的 Money 对 象 。 这 类 功 
能 都 是 非常 有 趣 的 ， 运 算 符 重 载 如 果 运 用 得 好 的 话 ， 可 以 玩 出 很 多 花样 。 

前 面 我 们 花 了 很 长 的 篇 幅 介 绍 加 号 运算 符 重 载 的 用 法 ， 但 实际 上 Kotlin 允 许 我 们 重 载 的 运算 符 和 
关键 字 多 达 十 几 个 。 显 然 这 里 我 不 可 能 将 每 一 种 重 载 的 用 法 都 逐个 进行 介绍 ,因此 我 在 表 5.2 中 
列 出 了 所 有 常用 的 可 重 载运 算 符 和 关键 字 对 应 的 语法 糖 表达 式 ， 以 及 它们 会 被 转换 成 的 实际 调 


用 函数 。 如 果 你 想 重 载 其 中 某 一 种 运算 符 或 关键 字 ， 


现 就 可 以 了 。 


表 5.2 语法 糖 表 达 式 和 实际 调用 函数 对 照 表 


只 要 参考 刚才 加 号 运算 符 重 载 的 写法 去 实 


语法 糖 表达 式 实际 调用 函数 
a + b a.plus(b) 
a-b a.minus(b) 
本 a.times(b) 
a / b a.div(b) 
a 5 b a.rem(b) 
a++ a.inc() 
a-- a.dec() 
+a a.unaryPlus() 
-a a.unaryMinus() 
1a a.not() 
a== |b 
a.equals(b) 
a<b 
a >= b 
a ly a.compareTo(b) 
ee a.rangeTo(b) 
a[lb] a.get(b) 
a[lb] = < a.set(b, c) 
a in b b.contains(a) 


注意 ,最 后 一 个 a in b 的 语法 糖 表达 式 对 应 的 实际 调用 吨 数 是 b .contains(a) , a、b 对 象 的 
顺序 是 反 过 来 的 。 这 在 语义 上 很 好 理解 ， 因 为 a in b 表 示 判 断 a 是 否 在 b 当 中 , 而 
b.contains(a) 表 示 判 断 b 是 否 包 含 a， 因 此 这 两 种 表达 方式 是 等 价 的 。 举 个 例子 ，Kotlin 中 的 
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String 类 就 对 contains ( ) 函数 进行 了 重 载 ， 因 此 当 我 们 判断 "heLLo "字符 串 中 是 否 包 
含 "he" 子 串 时 ，, 首先 可 以 这 样 写 : 


if ("hello".contains("he")) { 
} 


而 借助 重 载 的 语法 糖 表达 式 ， 我 们 也 可 以 这 样 写 : 


if ("he" in "hello") { 
} 


这 两 种 写法 的 效果 是 一 模 一 样 的 ， 但 后 者 显得 更 加 精简 一 些 。 


那么 关于 运算 符 重 载 的 内 容 就 学 到 这 里 。 接 下 来 ， 我 们 结合 刚刚 学 习 的 扩展 函数 以 及 运算 符 重 
载 的 知识 ， 对 之 前 编写 的 一 个 小 功能 进行 优化 。 


回想 一 下 ,在 第 4 章 和 本 章 中 ， 我 们 都 使 用 了 一 个 随机 生成 字符 串 长 度 的 函数 ,代码 如 下 所 示 : 


fun getRandomLengthString(str: String): String { 
val n = (1..20).random() 
val builder = StringBuilder() 
repeat(n) { 
builder.append(str) 


return builder.toString() 


} 


其 实 ， 这 个 函数 的 核心 思想 就 是 将 传 入 的 字符 串 重 复 n 次 ， 如 果 我 们 能 够 使 用 str * n 这 种 写法 
来 表示 让 str 字 符 串 重 复 / 次 ， 这 种 语法 体验 是 不 是 非常 棒 呢 ? 而 在 Kotlin 中 这 是 可 以 实现 的 。 

先 来 讲 一 下 思路 吧 。 要 让 一 个 字符 串 可 以 乘 以 一 个 数字 ， 那 么 肯定 要 在 St ring 类 中 重 载 乘 号 运 
算 符 才 行 ， 但 是 string 类 是 系统 提供 的 类 ， 我 们 无 法 修改 这 个 类 的 代码 。 这 个 时 候 就 可 以 借助 
扩展 函数 功能 向 String 类 中 添加 新 函数 了 。 


既然 是 向 String 类 中 添加 扩展 清 数 ， 那 么 我 们 还 是 打开 刚才 创建 的 String.kt 文 件 ， 然后 加 入 如 
下 代码 : 


operator fun String.times(n: Int): String { 
val builder = StringBuilder() 
repeat(n) { 
builder.append(this) 


return builder.toString() 


} 


这 上段 代码 应 该 不 难 理解 ， 这 里 只 讲 几 个 关键 的 点 。 首 先 ,operator 关 键 字 肯定 是 必 不 可 少 的 ; 
然后 既然 是 要 重 载 乘 号 运算 符 ， 参 考 表 5.2 可 知 ， 函 数 名 必须 是 times ; 最 后 ， 由 于 是 定义 扩展 
水 数 ， 因 此 还 要 在 方向 名 前 面 加 上 String .的 语法 结构 。 其 他 就 没什么 需要 解释 的 了 。 在 
times () 函 数 中 ， 我 们 借助 StringBuilder 和 repeat 函 数 将 字符 串 重复 /次 ， 最终 将 结果 返 
回 。 
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现在 ， 字 符 串 就 拥有 了 和 一 个 数字 相 乘 的 能 力 ， 比 如 执行 如 下 代码 : 


val str = "abc" * 3 
println(str) 


最 终 的 打印 结果 是 : abcabcabc。 


另外 ， 必须 说 明 的 是 ， 其实 Kotlin 的 String 类 中 已 经 提供 了 一 个 用 于 将 字符 串 重 复 n 遍 的 
repeat () 函 数 ， 因 此 times () 函数 还 可 以 进一步 精简 成 如 下 形式 : 


operator fun String.times(n: Int) = repeat(n) 


掌握 了 上 述 功能 之 后 ， 现 在 我 们 就 可 以 在 getRandomLengthSstring( ) 函数 中 使 用 这 种 魔术 一 
般 的 写法 了 ， 代 码 如 下 所 示 : 


fun getRandomLengthString(str: String) = str * (1..20).random() 


怎么 样 ， 有 没有 觉得 这 种 语法 用 起 来 特别 舒服 呢 ? 只 要 你 能 灵活 使 用 本 节 学 习 的 扩展 消 数 和 运 
算 符 重 载 ， 就 可 以 定义 出 更 多 有 趣 且 高 效 的 语法 结构 来 ， 本 书 在 后 续 章节 中 也 会 对 这 部 分 功能 
进行 更 多 的 拓展 。 
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5.7 小结 与 反 评 


你 应 该 可 以 感受 到 ， 在 最 佳 实践 环节 中 ， 我们 开发 的 新 闻 应 用 的 代码 复杂 度 还 是 有 点 高 的 。 比 
起 只 需要 兼容 一 个 终端 的 应 用 ， 我 们 要 考虑 的 东西 多 了 很 多 。 不 过 在 开发 的 过 程 中 多 付出 一 
些 , 在 以 后 的 代码 维护 中 就 可 以 轻松 很 多 。 因 此 ， 有 时 候 提前 付出 还 是 很 值得 的 。 


下 面 我 们 来 回顾 一 下 本 章 所 学 的 内 容 吧 。 首 先 你 了 解 了 Fragment 的 基本 概念 和 使 用 场景 ， 然后 
通过 几 个 实例 掌握 了 Fragment 的 常见 用 法 ， 随 后 学 习 了 Fragment 生 命 周 期 的 相关 内 容 以 及 动 
态 加 载 布局 的 技巧 ， 最 后 在 本 章 的 最 佳 实 践 部 分 将 前 面 所 学 的 内 容 综合 运用 了 一 遍 , 相信 你 已 
经 将 Fragment 相 关 的 知识 点 都 牢记 在 心 ， 并 可 以 较为 熟练 地 应 用 了 。 另 外 , 本章 的 Kotlin 课 堂 
可 以 说 是 格外 充实 ， 我 们 学 习 了 扩展 汶 数 和 运算 符 重 载 这 两 种 非常 有 用 的 技术 ， 并 结合 这 两 种 
技术 实现 了 一 些 非常 有 趣 的 功能 。 


本 章 其 实 是 具有 里 程 碑 式 的 意义 的 ， 因 为 到 这 里 为 止 ， 我 们 已 经 基本 将 Android UI 相关 的 重要 

知识 点 都 讲 完了 。 后 面 在 很 长 一 段 时 间 内 都 不 会 再 系统 性 地 介绍 UI 方面 的 知识 ， 而 是 将 结合 前 

面 所 学 的 UI 知识 来 更 好 地 讲解 相应 章节 的 内 容 。 那 么 我 们 下 一 章 将 要 学 习 什 么 呢 ? 还 记得 在 第 1 
章 里 介绍 过 的 Android 四 大 组 件 吧 ? 目前 我 们 只 掌握 了 Activity 这 一 个 组 件 ， 那么 下 一 章 就 来 学 
习 BroadcastReceiver 吧 。 跟 上 脚步 ， 准 备 继续 前 进 ! 
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第 6 章 全 局 大 喇叭 ， 详 解 广 播 机 制 


记得 在 我 上 学 的 时 候 ,每 个 班级 的 教室 里 都 装 有 一 个 喇叭 ， 这 些 喇 叭 接 到 学 校 的 广播 室 ,一 旦 
有 什么 重要 的 通知 ， 就 会 播放 一 条 广播 来 告知 全 校 的 师 生 。 类 似 的 工作 机 制 其 实在 计算 机 领域 
也 有 很 广泛 的 应 用 ， 如 果 你 了 解 网 络 通信 原理 ,应 该 会 知道 ， 在 一 个 IP 网 络 范 围 中 ， 最 大 的 IP 地 
址 是 被 保留 作为 广播 地 址 来 使 用 的 。 比 如 某 个 网 络 的 IP 范 围 是 192.168.0.XXX , 子 网 掩 码 是 
255.255.255.0 , 那么 这 个 网 络 的 广播 地 址 就 是 192.168.0.255。 广 播 数 据 包 会 被 发 送 到 同一 
网 络 上 的 所 有 端口 ， 这 样 该 网 络 中 的 每 台 主 机 都 会 收 到 这 条 广播 。 


为 了 便于 进行 系统 级 别 的 消息 通知 , Android 也 引入 了 一 套 类 似 的 广播 消息 机 制 。 相 比 于 我 前 面 


举 的 两 个 例子 ，Android 中 的 广播 机 制 显 得 更 加 灵活 ， 本 章 就 将 对 这 一 机 制 的 方方面面 进行 详细 
的 讲解 。 
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6.1 广播 机 制 简介 


为 什么 说 Android 中 的 广播 机 制 更 加 灵活 呢 ? 这 是 因为 Android 中 的 每 个 应 用 程序 都 可 以 对 自己 
感 兴趣 的 广播 进行 注册 ， 这样 该 程序 就 只 会 收 到 自己 所 关心 的 广播 内 容 ,这些 广播 可 能 是 来 自 
于 系统 的 ， 也 可 能 是 来 自 于 其 他 应 用 程序 的 。Android 提 供 了 一 套 完 整 的 API ， 人 允许 应 用 程序 自 
由 地 发 送 和 接收 广播 。 发 送 广播 的 方法 其 实 之 前 稍微 提 到 过 ,如果 你 记性 好 的 话 ， 可 能 还 会 有 
印象 ， 就 是 借助 我 们 第 3 章 学 过 的 Intent。 而 接收 广播 的 方法 则 需要 引入 一 个 新 的 概念 一 一 
BroadcastReceiver。 
BroadcastReceiver 的 具体 用 法 将 会 在 下 一 节 介绍 ， 这 里 我 们 先 来 了 解 一 下 广播 的 类 型 。 
Android 中 的 广播 主要 可 以 分 为 两 种 类 型 : 标准 广播 和 有 序 广播 。 
。 标准 广播 (normal broadcasts) 是 一 种 完全 异步 执行 的 广播 ， 在 广播 发 出 之 后 ， 所 有 的 
BroadcastReceiver 几 乎 会 在 同一 时 刻 收 到 这 条 广播 消息 ,因此 它们 之 间 没 有 任何 先后 顺 
序 可 言 。 这 种 广播 的 效率 会 比较 高 ， 但 同时 也 意味 着 它 是 无 法 被 截断 的 。 标 准 广播 的 工作 
流程 如 图 6.1 所 示 。 


BroadcastReceiverl 


发 出 一 条 广播 >| “BroadcastReceiver2 


BroadcastReceiver3 


图 6.1 标准 广播 工作 示意 图 


有 序 广播 (ordered broadcasts) 则 是 一 种 同步 执行 的 广播 ,在 广播 发 出 之 后 ， 同 一 时 刻 
只 会 有 一 个 BroadcastReceiver 能 够 收 到 这 条 广播 消息 ， 当 这 个 BroadcastReceiver 中 的 
逻辑 执行 完毕 后 ， 广 播 才 会 继续 传递 。 所 以 此 时 的 BroadcastReceiver 是 有 先后 顺序 的 ， 

优先 级 高 的 BroadcastReceiver 就 可 以 先 收 到 广播 消息 ， 并 且 前 面 的 BroadcastReceiver 
还 可 以 截断 正在 传递 的 广播 ， 这 样 后 面 的 BroadcastReceiver 就 无 法 收 到 广播 消息 了 。 有 
序 广播 的 工作 流程 如 图 6.2 所 示 。 


发 出 一 条 广播 > BroadcastReceiverl | >) BroadcastReceiver 2 “| 一 ->| BroadcastReceiver3 


可 将 广播 截断 可 将 广播 截断 


图 6.2 有 序 广播 工作 示意 图 
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掌握 了 这 些 基 本 概念 后 ， 我 们 就 可 以 来 学 习 广播 的 用 法 了 ， 首 先 从 接收 系统 广播 开始 吧 。 
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6.2 ”接收 系统 广播 


Android 内 置 了 很 多 系统 级 别 的 广播 ， 我 们 可 以 在 应 用 程序 中 通过 监听 这 些 广播 来 得 到 各 种 系统 
的 状态 信息 。 比 如 手机 开机 完成 后 会 发 出 一 条 广播 ,电池 的 电量 发 生变 化 会 发 出 一 条 广播 ， 系 
统 时 间 发 生 改变 也 会 发 出 一 条 广播 ， 等 等 。 如 果 想 要 接收 这 些 广播 ， 就 需要 使 用 
BroadcastReceiver ,下面 我 们 就 来 看 一 下 它 的 具体 用 法 。 


6.2.1 动态 注册 监听 时 间 变 化 


我 们 可 以 根据 自己 感 兴趣 的 广播 ， 自 由 地 注册 BroadcastReceiver , 这 样 当 有 相应 的 广播 发 出 
时 ， 相应 的 BroadcastReceiver 就 能 够 收 到 该 广播 ， 并 可 以 在 内 部 进行 逻辑 处 理 。 注 册 
BroadcastReceiver 的 方式 一 般 有 两 种 : 在 代码 中 注册 和 在 AndroidManifest.xml 中 注册 。 其 
中 前 者 也 被 称 为 动态 注册 ， 后 者 也 被 称 为 静态 注册 。 


那么 如 何 创 建 一 个 BroadcastReceiver 呢 ? 其 实 只 需 新 建 一 个 类 ， 让 它 继承 自 
BroadcastReceiver ,并 重 写 父 类 的 onReceive() 方 法 就 行 了 。 这 样 当 有 广播 到 来 时 ， 
onReceive() 方 法 就 会 得 到 执行 ， 具 体 的 逻辑 就 可 以 在 这 个 方法 中 人 处理。 


下 面 我 们 就 先 通 过 动态 注册 的 方式 编写 一 个 能 够 监听 时 间 变 化 的 程序 ， 借 此 学 习 一 下 
BroadcastReceiver 的 基本 用 法 。 新 建 一 个 BroadcastTest 项 目 ， 然 后 修改 MainActivity 中 的 
代码 ,如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
lateinit var timeChangeReceiver: TimeChangeReceiver 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val intentFilter = IntentFilter() 
intentFilter.addAction("android.intent.action.TIME TICK") 
timeChangeReceiver = TimeChangeReceiver() 
registerReceiver(timeChangeReceiver, intentFilter) 


} 


override fun onDestroy() { 
super.onDestroy() 
unregisterReceiver(timeChangeReceiver) 


} 
inner class TimeChangeReceiver : BroadcastReceiver() { 


override fun onReceive(context: Context, intent: Intent) { 
Toast.makeText(context, "Time has changed", Toast.LENGTH SHORT).show() 


} 


可 以 看 到 ,我们 在 MainActivity 中 定义 了 一 个 内 部 类 TimeChangeReceiver ,这 个 类 是 继承 
自 BroadcastReceiver 的 ,并 重 写 了 父 类 的 onReceive() 方 法 。 这 样 每 当 系统 时 间 发 生变 化 
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时 ,onReceive( ) 方 法 就 会 得 到 执行 ， 这 里 只 是 简单 地 使 用 Toast 提 示 了 一 段 文本 信息 。 


然后 观察 onCreate( ) 方 法 ， 首 先 我 们 创建 了 一 个 IntentFitLter 的 实例 ， 并 给 它 添加 了 一 个 
值 为 android.intent.action.TIME TICK 的 action ,为 什么 要 添加 这 个 值 呢 ? 因为 当 系 统 
时 间 发 生变 化 时 ,系统 发 出 的 正 是 一 条 值 为 android.intent.action.TIME_TICK 的 广播 ， 
也 就 是 说 我 们 的 BroadcastReceiver 想 要 监听 什么 广播 ， 就 在 这 里 添加 相应 的 action。 接 下 
来 创建 了 一 个 TimeChangeReceiver 的 实例 ,然后 调用 registerReceiver () 方 法 进行 注 
册 ,将 TimeChangeReceiver 的 实例 和 IntentFiLter 的 实例 都 传 了 进去 , 这 样 
TimeChangeReceiver 就 会 收 到 所 有 值 为 android.intent,action.TIME TICK 的 广播 ， 
也 就 实现 了 监听 系统 时 间 变 化 的 功能 。 


最 后 要 记得 ， 动态 注册 的 BroadcastReceiver 一 定 要 取消 注册 才 行 ， 这 里 我 们 是 在 
onDestroy () 方 法 中 通过 调用 unregisterReceiver() 方 法 来 实现 的 。 

整体 来 说 ， 代 码 还 是 非常 简单 的 。 现 在 运行 一 下 程序 ， 然 后 静 静 等 待 时 间 发 生变 化 。 系 统 每 隔 
一 分 钟 就 会 发 出 一 条 android.intent.action.TIME_TICK 的 广播 ， 因 此 我 们 最 多 只 需要 等 
待 一 分 钟 就 可 以 收 到 这 条 广播 了 ， 如 图 6.3 所 示 。 
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11:33 


BroadcastTest 


Time has changed 


图 6.3 ”监听 到 系统 时 间 发 生 了 变化 

这 就 是 动态 注册 BroadcastReceiver 的 基本 用 法 ， 虽 然 这 里 我 们 只 使 用 了 一 种 系统 广播 来 举 
例 ， 但 是 接收 其 他 系统 广播 的 用 法 是 一 模 一 样 的 。Android 系 统 还 会 在 亮 屏 熄 屏 、 电 量变 化 、 网 
络 变化 等 场景 下 发 出 广播 。 如 果 你 想 查 看 完整 的 系统 广播 列表 ,可 以 到 如 下 的 路 径 中 去 查看 : 


<Android SDK>/platforms/< 任 意 android api 版 本 >/data/broadcast actions .txt 


6.2.2 静态 注册 实现 开机 启动 


动态 注册 的 BroadcastReceiver 可 以 自由 地 控制 注册 与 注销 ， 在 灵活 性 方面 有 很 大 的 优 热 。 但 
是 它 存在 着 一 个 缺点 ， 即 必须 在 程序 启动 之 后 才能 接收 广播 ， 因 为 注册 的 逻辑 是 写 在 
onCreate( ) 方 法 中 的 。 那 么 有 没有 什么 办 法 可 以 让 程序 在 未 启动 的 情况 下 也 能 接收 广播 呢 ? 


这 就 需要 使 用 静态 注册 的 方式 了 。 
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其 实 从 理论 上 来 说 ， 动 态 注册 能 监听 到 的 系统 广播 ， 静 态 注 册 也 应 该 能 监听 到 ， 在 过 去 的 
We 但 是 由 于 大 量 恶意 的 应 用 程序 利用 这 个 机 制 在 程序 未 启动 的 情况 
播 ， 从 而 使 任何 应 用 都 可 以 频繁 地 从 后 台 被 唤醒 ， 严 重 影响 了 用 户 手 机 的 电量 和 

, 因此 Android 系 统 几 乎 每 个 版 本 都 在 削减 静态 注册 BroadcastReceiver 的 功能 。 


在 Android 8.0 系 统 之 后 ， 所 有 隐 式 广播 都 不 允许 使 用 静态 注册 的 方式 来 接收 了 。 隐 式 广播 指 的 
是 那些 没有 具体 指定 发 送 给 哪个 应 用 程序 的 广播 ， 大 多 数 系统 广播 属于 隐 式 广播 ， 但 是 少数 特 
殊 的 系统 广播 目前 仍然 允许 使 用 静态 注册 的 方式 来 接收 。 这 些 特殊 的 系统 广播 列表 详 见 
https://developer.android.google.cn/guide/components/broadcast- 

exceptions.html, 


在 这 些 特殊 的 系统 广播 当中 ， 有 一 条 值 为 android.intent.action.B00T COMPLETED 的 广 
播 ， 这 是 一 条 开机 广播 ， 那 么 就 使 用 它 来 举例 学 习 吧 。 


这 里 我 们 准备 实现 一 个 开机 启动 的 功能 。 在 开机 的 时 候 ， 我 们 的 应 用 程序 肯定 是 没有 启动 的 ， 
因此 这 个 功能 显然 不 能 使 用 动态 注册 的 方式 来 实现 ， 而 应 该 使 用 静态 注册 的 方式 来 接收 开机 广 
播 ， 然 后 在 onReceive ( ) 方 法 里 执行 相应 的 逻辑 , 这 样 就 可 以 实现 开机 启动 的 功能 


那么 就 开始 动手 吧 。 上 一 小 节 中 我 们 是 使 用 内 部 类 的 方式 创建 的 BroadcastReceiver , 其 实 还 
可 以 通过 Android Studio 提 供 的 快捷 方式 来 创建 。 右 击 com.example.broadcasttest 包 
New 一 Other>Broadcast Receiver , 会 弹出 如 图 6.4 所 示 的 窗口 。 


EE [3 New Android Component 


Configure Component 


Android Studio 


Creates a new broadcast receiver component and adds it to your 
Android manifest. 


Class Name: BootCompleteReceiver 
Exported 
Enabled 


Source Language: Kotlin 


图 6.4 ”创建 BroadcastReceiver 的 窗口 
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可 以 看 到 ， 这 里 我 们 将 创建 的 类 命名 为 BootCompleteReceiver ,Exported 属 性 表示 是 否 允 
许 这 个 BroadcastReceiver 接 收 本 程序 以 外 的 广播 ，Enabled 属 性 表示 是 否 局 用 这 个 
BroadcastReceiver。 勾 选 这 两 个 属性 ， 点击“Finish” 完 成 创建 。 


然后 修改 BootCompleteReceiver 中 的 代码 , 如 下 所 示 : 


class BootCompleteReceiver : BroadcastReceiver() { 


override fun onReceive(context: Context, intent: Intent) { 
Toast.makeText(context, "Boot Complete", Toast.LENGTH LONG) .show() 


} 


代码 非常 简单 ， 我 们 只 是 在 onReceive() 方 法 中 使 用 Toast 弹 出 一 段 提示 信息 。 


另外 ,静态 的 BroadcastReceiver 一 定 要 在 AndroidManifest.xm| 文 件 中 注册 才 可 以 使 用 。 不 
过 ,由 于 我 们 是 使 用 Android Studio 的 快捷 方式 创建 的 BroadcastReceiver , 因此 注册 这 一 步 
已 经 自动 完成 了 。 打 开 AndroidManifest.xm| 文 件 瞧 一 瞧 ， 代码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=" .BootCompleteReceiver" 
android:enabled="true" 
android:exported="true"> 
</receiver> 
</application> 


</manifest> 


可 以 看 到 ,<application> 标 签 内 出 现 了 一 个 新 的 标签 <receiver> ,所 有 静态 的 
BroadcastReceiver 都 是 在 这 里 进行 注册 的 。 它 的 用 法 其 实 和 <activity> 标 签 非常 相似 , 也 
是 通过 android :name 指 定 具 体 注 册 哪 一 个 BroadcastReceiver , 而 enabled 和 exported 属 
性 则 是 根据 我 们 刚才 勾 选 的 状态 自动 生成 的 。 


不 过 目前 的 BootCompleteReceiver 是 无 法 收 到 开机 广播 的 ， 因 为 我 们 还 需要 对 
AndroidManifest.xm| 文 件 进行 修改 才 行 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.RECEIVE BOOT COMPLETED" /> 
<application 


android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 


www.blogss.cn 


android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<receiver 
android:name=" .BootCompleteReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 
<action android:name="android.intent.action.BOOT COMPLETED" /> 
</intent-filter> 
</receiver> 
</application> 


</manifest> 


由 于 Android 系 统 启动 完成 后 会 发 出 一 条 值 为 android.intent.action.BOOT COMPLETED 
的 广播 ， 因 此 我 们 在 <receiver> 标 签 中 又 添加 了 一 个 <intent-filter> 标 签 ， 并 在 里 面 声 
明了 相应 的 action。 


另外 ,这 里 有 非常 重要 的 一 点 需要 说 明 。Android 系统 为 了 保护 用 户 设备 的 安全 和 隐私 ， 做 了 
严格 的 规定 : 如 果 程 序 需要 进行 一 些 对 用 户 来 说 比较 敏感 的 操作 ， 必须 在 
AndroidManifest.xml 文 件 中 进行 权限 声明 ,否则 程序 将 会 直接 崩 演 。 比 如 这 里 接收 系统 的 开 
机 广播 就 是 需要 进行 权限 声明 的 ， 所 以 我 们 在 上 述 代码 中 使 用 <uses-permission> 标 签 声明 
了 android.permission,RECEIVE_B00T_ COMPLETED 权 限 。 


这 是 你 第 一 次 遇 到 权限 的 问题 ,其实 Android 中 的 许多 操作 是 需要 声明 权限 才 可 以 进行 的 ,后 
面 我 们 还 会 不 断 使 用 新 的 权限 。 不 过 目前 这 个 接收 系统 开机 广播 的 权限 还 是 比较 简单 的 ， 只 需 
要 在 AndroidManifest.xm | 文件 中 声明 一 下 就 可 以 了 。Android 6.0 系统 中 引入 了 更 加 严格 
的 运行 时 权限 ， 从 而 能 够 更 好 地 保证 用 户 设备 的 安全 和 隐私 。 关 于 这 部 分 内 容 我 们 将 在 第 8 章 
中 学 习 。 


重新 运行 程序 ， 现在 我 们 的 程序 已 经 可 以 接收 开机 广播 了 。 长 按 模拟 硕 右 侧 工 具 栏 中 的 Power 
按钮 ,会 在 模拟 器 界面 上 弹出 关机 重 局 选项 ,如 图 6.5 所 示 。 
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SuUnday 用 JUDP23 


山 


Power off 


0 


Restart 


图 6.5 模拟 器 的 关机 重启 选项 
点 击 “Restart” 按 钮 重启 模拟 器 ， 在 启动 完成 之 后 就 会 收 到 开机 广播 ， 如 图 6.6 所 示 。 
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图 6.6 ”接收 系统 开机 广播 

到 目前 为 止 ， 我们 在 BroadcastReceiver 的 onReceive() 方 法 中 只 是 简单 地 使 用 Toast 提 示 了 
一 段 文本 信息 ， 当 你 真正 在 项 目 中 使 用 它 的 时 候 ， 可 以 在 里 面 编写 自己 的 逻辑 。 需 要 注意 的 

是 , 不 要 在 onReceive() 方 法 中 添加 过 多 的 逻辑 或 者 进行 任何 的 耗 时 操作 ， 因 为 
BroadcastReceiver 中 是 不 允许 开启 线程 的 ， 当 onReceive( ) 方 法 运行 了 较 长 时 间 而 没有 结 
束 时 ， 程序 就 会 出 现 错误 。 
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6.3 人 


现在 你 已 经 学 会 了 通过 BroadcastReceiver 来 接收 系统 广播 ， 接 下 来 我 们 就 要 学 习 一 下 如 何在 
应 用 程序 ee 播 。 前 面 已 经 介绍 过 了 ， 广播 主要 分 为 两 种 类 型 : 标准 广播 和 有 序 
广播 。 本 节 我 们 就 通过 实践 的 方式 来 看 一 下 这 两 种 广播 具体 的 区 别 。 


6.3.1 发 送 标准 广播 


在 发 送 广播 之 前 ， 我 们 还 是 需要 先 定义 一 个 BroadcastReceiver 来 准备 接收 此 广播 ， 不 然 发 出 
去 也 是 白 发 。 因 此 新 建 一 个 MyBroadcastReceiver , 并 在 onReceive( ) 方 法 中 加 入 如 下 代 


但 : 


class MyBroadcastReceiver : BroadcastReceiver() { 


override fun onReceive(context: Context, intent: Intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", 
Toast.LENGTH SHORT).show() 


} 


当 MyBroadcastReceiver 收 到 自 定义 的 广播 时 ， 就 会 弹出 “received in 
MyBroadcastReceiver "的 提示 。 


然后 在 AndroidManifest.xmI 中 对 这 个 BroadcastReceiver 进 行 修改 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<receiver 
android:name=" .MyBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 
<action android:name="com.example.broadcasttest.MY BROADCAST"/> 
</intent-filter> 
</receiver> 
</application> 
</manifest> 


可 以 看 到 ， 这 里 让 MyBroadcastReceiver 接 收 一 条 值 为 
com.example.broadcasttest .MY BROADCAST 的 广播 ， 因 此 待 会 儿 在 发 送 广 播 的 时 候 , 我 


们 就 需要 发 出 这 样 的 一 条 广播 。 
接 下 来 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/button" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Send Broadcast" 
/> 


</LinearLayout> 


这 里 在 布局 文件 中 定义 了 一 个 按钮 ， 用 于 作为 发 送 广播 的 触发 点 。 然 后 修改 MainActivity 中 的 
代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
button.setOnClickListener { 
val intent = Intent("com.example.broadcasttest.MY BROADCAST") 
intent.setPackage(packageName) 
sendBroadcast (intent) 


} 


可 以 看 到 ， 我们 在 按钮 的 点 击 事件 里 面 加 入 了 发 送 自 定义 广播 的 逻辑 。 


首先 构建 了 一 个 Intent 对 象 ， 并 把 要 发 送 的 广播 的 值 传 入 。 然 后 调用 Intent 的 setPackage() 
方法 ， 并 传 入 当前 应 用 程序 的 包 名 。packageName 是 getPackageName ( ) 的 语法 糖 写法 ， 用 
于 获取 当前 应 用 程序 的 包 名 。 最 后 调用 sendBroadcast( ) 方 法 将 广播 发 送出 去 ， 这样 所 有 监 
听 com.example.broadcasttest.MY BROADCAST 这 条 广播 的 BroadcastReceiver 就 会 收 
到 消息 了 。 此 时 发 出 去 的 广播 就 是 一 条 标准 广播 。 


这 里 我 还 得 对 第 2 步调 用 的 SetPackage( ) 方 法 进行 更 详细 的 说 明 。 前 面 已 经 说 过 ,在 Android 
8.0 系 统 之 后 ,静态 注册 的 BroadcastReceiver 是 无 法 接收 隐 式 广播 的 ， 而 默认 情况 下 我 们 发 出 
的 自 定义 广播 恰恰 都 是 隐 式 广播 。 因 此 这 里 一 人 ) 方 法 ， 指 定 这 条 广播 是 
发 送 给 哪个 应 用 程序 的 ， 从 而 让 它 变 成 一 条 显 式 广播 ， 否 则 静态 注册 的 BroadcastReceiver 将 
无 法 接收 到 这 条 广播 。 


现在 重新 运行 程序 ， 并 点 击 “Send Broadcast" 按 钮 ， 效 果 如 图 6.7 所 示 。 


www.blogss.cn 


9:51 sh 
BroadcastTest 


SEND BROADCAST 


received in MyBroadcastReceiver 


图 6.7 ”接收 到 自 定义 广播 

这 样 我 们 就 成 功 完 成 了 发 送 自 定义 广播 的 功能 。 

另外 ,由 于 广播 是 使 用 Intent 来 发 送 的 ， 因 此 你 还 可 以 在 Intent 中 携带 一 些 数据 传递 给 相应 的 
BroadcastReceiver , 这 一 点 和 Activity 的 用 法 是 比较 相似 的 。 

6.3.2 发 送 有 序 广播 


和 标准 广播 不 同 ， 有 序 广播 是 一 种 同步 执行 的 广播 ， 并 且 是 可 以 被 截断 的 。 为 了 验证 这 一 点 ， 
我 们 需要 再 创建 一 个 新 的 BroadcastReceiver。 新 建 AnotherBroadcastReceiver ,代码 如 下 


所 示 : 


class AnotherBroadcastReceiver : BroadcastReceiver() { 


override fun onReceive(context: Context, intent: Intent) { 
Toast .makeText (context, "received in AnotherBroadcastReceiver", 
Toast.LENGTH SHORT).show() 
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很 简单 ， 这 里 仍然 是 在 onReceive ( ) 方 法 中 弹出 了 一 段 文本 信息 。 


然后 在 AndroidManifest.xml 中 对 这 个 BroadcastReceiver 的 配置 进行 修改 ， 代 码 如 下 所 示 : 


</manifest> 


<manifest xmlns: 
package="com.example.broadcasttest"> 


<application 
android: 
android: 
android: 
android: 
android: 
android: 


android="http://schemas.android.com/apk/res/android" 


allowBackup="true" 

icon="@mipmap/ic launcher" 
label="@string/app_name" 
roundIcon="@mipmap/ic launcher_ round" 
supportsRtl="true" 
theme="@style/AppTheme"> 


<receiver 
android:name=".AnotherBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter> 


<action android:name="com.example.broadcasttest.MY BROADCAST" /> 


</intent-filter> 
</receiver> 
</application> 


可 以 看 到 ， AnotherBroadcastReceiver 同 样 接收 的 是 
com.exampLe.broadcasttest.MY_ BROADCAST 这 条 广播 。 现 在 重新 运行 程序 ,并 点 
击 “Send Broadcast" 按 钮 ， 就 会 分 别 弹出 两 次 提示 信息 ,如 图 6.8 所 示 。 
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received in MyBroadcastReceiver received in AnotherBroadcastReceiver 


图 6.8 两 个 BroadcastReceiver 都 接收 到 了 自 定义 广播 


不 过 ， 到 目前 为 止 ，, 程序 发 出 的 都 是 标准 广播 ， 现在 我 们 来 尝试 一 下 发 送 有 序 广播 。 重 新 回 到 
ee , 然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
button.setOnClickListener { 
val intent = Intent("com.example.broadcasttest.MY BROADCAST") 
intent.setPackage(packageName) 
sendOrderedBroadcast(intent, null) 


} 


可 以 看 到 ， 发 送 有 序 广 播 只 需要 改动 一 行 代码 ， 即 将 sendBroadcast ( ) 方 法 改 成 
sendo0rderedBroadcast () 方 法 。sendo0rderedBroadcast ( ) 方 法 接收 两 个 参数 : 第 一 个 
参数 仍然 是 Intent ; 第 二 个 参数 是 一 个 与 权限 相关 的 字符 串 ， 这 里 传 入 nuLL 就 行 了 。 现 在 重 
新 运行 程序 , 并 点 击 “Send Broadcast" 按 钮 ， 你 会 发 现 ， 两 个 BroadcastReceiver 仍 然 都 可 
以 收 到 这 条 广播 。 


看 上 去 好 像 和 标准 广播 并 没有 什么 区 别 嘛 。 不 过 别 忘 了 ， 这 个 时 候 的 BroadcastReceiver 是 有 
先后 顺序 的 ， 而且 前 面 的 BroadcastReceiver 还 可 以 将 广播 截断 ， 以 阻止 其 继续 传播 。 
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那么 该 如 何 设 定 BroadcastReceiver 的 先后 顺序 呢 ? 当然 是 在 注册 的 时 候 进行 设 定 了 ， 修 改 
AndroidManifest.Xxml 中 的 代码 ,如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<receiver 
android:name=" .MyBroadcastReceiver" 
android:enabled="true" 
android:exported="true"> 
<intent-filter android:priority="100"> 
<action android:name="com.example.broadcasttest.MY BROADCAST"/> 
</intent-filter> 
</receiver> 


</application> 
</manifest> 


可 以 看 到 ， 我 们 通过 android :priority 属 性 给 BroadcastReceiver 设 置 了 优先 级 ， 优 先 级 
比较 高 的 BroadcastReceiver 就 可 以 先 收 到 广播 。 这 里 将 MyBroadcastReceiver 的 优先 级 设 
成 了 100 , 以 保证 它 一 定 会 在 AnotherBroadcastReceiver 之 前 收 到 广播 。 


既然 已 经 获得 了 接收 广播 的 优先 权 ,那么 MyBroadcastReceiver 就 可 以 选择 是 否 人 允许 广播 继续 
传递 了 。 修 改 MyBroadcastReceiver 中 的 代码 ， 如 下 所 示 : 


class MyBroadcastReceiver : BroadcastReceiver() { 


override fun onReceive(context: Context, intent: Intent) { 
Toast.makeText(context, "received in MyBroadcastReceiver", 
Toast.LENGTH SHORT).show() 
abortBroadcast() 


} 


如 果 在 onReceive ( ) 方 法 中 调用 了 abortBroadcast() 方 法 ,就 表示 将 这 条 广播 截断 ， 后面 
的 BroadcastReceiver 将 无 法 再 接收 到 这 条 广播 。 


现在 重新 运行 程序 , 并 点 击 “Send Broadcast” 按 钮 ， 你 会 发 现 只 有 MyBroadcastReceiver 中 
的 Toast 信 息 能 够 弹出 ， 说 明 这 条 广播 经 过 MyBroadcastReceiver 之 后 确实 终止 传递 了 。 
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6.4 广播 的 最 佳 实践 : 实现 强制 下 线 功 能 


本 章 的 内 容 不 是 非常 多 ， 相信 你 一 定 学 得 很 轻松 吧 。 现 在 我 们 就 准备 通过 一 个 完整 例子 的 实 
践 ， 综 合 运用 一 下 本 章 所 学 到 的 知识 。 


强制 下 线 应 该 算是 一 个 比较 常见 的 功能 ， 比 如 如 果 你 的 QQ 号 在 别处 登录 了 ， 就 会 将 你 强制 挤 下 
线 。 其 实 实现 强制 下 线 功能 的 思路 比较 简单 ， 只 需要 在 界面 上 弹出 一 个 对 话 框 ， 让 用 户 无 法 进 

行 任何 其 他 操作 ， 必须 点 击 对 话 框 中 的 “确定 ”按钮 ,然后 回 到 登录 界面 即 可 。 可 是 这 样 就 会 存 

在 一 个 问题 : 当 用 户 被 通知 需要 强制 下 线 时 ， 可 能 正 处 于 任何 一 个 界面 ， 难道 要 在 每 个 界面 上 

都 编写 一 个 弹出 对 话 框 的 逻辑 ? 如 果 你 真 的 这 么 想 ， 那 思路 就 偏远 了 。 我 们 完全 可 以 借助 本 章 

所 学 的 广播 知识 ， 非 常 轻松 地 实现 这 一 功能 。 新 建 一 个 BroadcastBestPractice 项 目 ， 然 后 开 
始 动手 吧 。 


强制 下 线 功 能 需要 先 关 闭 所 有 的 Activity ,然后 回 到 登录 界面 。 如 果 你 的 反应 足够 快 ,应 该 会 想 
到 我 们 在 第 3 章 的 最 佳 实践 部 分 已 经 实现 过 关闭 所 有 Activity 的 功能 了 ， 因 此 这 里 使 用 同样 的 方 
案 即 可 。 先 创建 一 个 ActivityCoLLector 类 用 于 管理 所 有 的 Activity， 代码 如 下 所 示 : 
object ActivityCollector { 

private val activities = ArrayList<Activity>() 

fun addActivity(activity: Activity) { 


activities.add(activity) 


fun removeActivity(activity: Activity) { 
activities.remove(activity) 


} 


fun finishALL() { 
for (activity in activities) { 
if (!activity.isFinishing) { 
activity.finish() 
} 


activities.clear() 


} 
} 


然后 创建 BaseActivity 类 作为 所 有 Activity 的 父 类 ， 代码 如 下 所 示 : 


open class BaseActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
ActivityCollector.addActivity(this) 

} 


override fun onDestroy() { 
super.onDestroy() 
ActivityCollector.removeActivity(this) 


} 
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以 上 代码 都 是 直接 用 的 之 前 写 好 的 内 容 ， 非常 开心 。 这 里 开始 ， 就 要 靠 我 们 自己 去 动手 
实现 了 。 首 先 需要 创建 一 Ge 并 让 Android Studio 帮 有 我 们 自 
动 生成 相应 的 布局 文件 。 然 后 编辑 布局 文件 activity_login.xml , 代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<LinearLayout 

android:orientation="horizontal" 

android:layout width="match parent" 

android:layout height="60dp"> 

<TextView 
android:Layout width="90dp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:textSize="18sp" 
android:text="Account:" /> 


<EditText 
android:id="@+id/accountEdit" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:layout gravity="center vertical" /> 
</LinearLayout> 


<LinearLayout 

android:orientation="horizontal" 

android:layout width="match parent" 

android:layout height="60dp"> 

<TextView 
android:layout width="90dp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:textSize="18sp" 
android:text="Password:" /> 


<EditText 

android:id="@+id/passwordEdit" 
android:layout width="0dp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:layout gravity="center vertical" 
android:inputType="textPassword" /> 

</LinearLayout> 


<Button 
android:id="@+id/login" 
android:layout width="200dp" 
android:layout height="60dp" 
android:Layout gravity="center horizontal" 
android:text="Login" /> 


</LinearLayout> 


这 de Mi OR 录 布 局 , 最 外 层 是 一 个 纵向 的 LinearLayout , 里 面 
包含 了 3 行 直 接 子 元 素 。 第 一 行 是 一 个 横向 的 LinearLayout ,用 于 输入 账号 信息 ; 第 二 行 也 是 


www.blogss.cn 


一 个 横向 的 LinearLayout ,用 于 输入 密码 信息 ; 第 三 行 是 一 个 登录 按钮 。 这 个 布局 文件 里 用 到 
的 全 部 都 是 我 们 之 前 学 过 的 内 容 ， 相 信 你 理解 起 来 应 该 不 会 费劲 。 


接 下 来 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


class LoginActivity : BaseActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity login) 
login.setOnClickListener { 
val account = accountEdit.text.toString() 
val password = passwordEdit.text.toString() 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account == "admin" && password == "123456") { 
val intent = Intent(this, MainActivity::class.java) 
startActivity(intent) 
finish() 
} else { 
Toast.makeText(this, "account or password is invalid", 
Toast .LENGTH _ SHORT) .show'() 


} 


这 里 我 们 模拟 了 一 个 非常 简单 的 登录 功能 。 首 先 将 LoginActivity 的 继承 结构 改 成 继承 自 
BaseActivity， 然 后 在 登录 按钮 的 点 击 事件 里 对 输入 的 账号 和 密码 进行 判断 : 如 果 账 号 是 
admin 并 且 密 码 是 123456， 就 认为 登录 成 功 并 跳 转 到 MainActivity， 否则 就 提示 用 户 账号 或 
密码 错误 。 


因此 ,你 可 以 将 MainActivity 理 解 成 是 登录 成 功 后 进入 的 程序 主 界面 ， 这 里 我 们 并 不 需要 在 主 
界面 提供 什么 花哨 的 功能 ， 只 需要 加 入 强制 下 线 功能 就 可 以 了 。 修 改 activity_main.xml 中 的 代 
码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/force0Offline" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Send force offline broadcast" /> 


</LinearLayout> 


非常 简单 ， 只 有 一 个 按钮 用 于 触发 强制 下 线 功能 。 然 后 修改 MainActivity 中 的 代码 ,如 下 所 
小 : 


class MainActivity : BaseActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
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forceOffline.setOnClickListener { 
val intent = Intent("com.example.broadcastbestpractice.FORCE OFFLINE") 
sendBroadcast (intent) 


} 


同样 非常 简单 ， 不 过 这 里 有 个 重点 ， 我 们 在 按钮 的 点 击 事件 里 发 送 了 一 条 广播 ，, 广播 的 值 为 

com.example.broadcastbestpractice.FORCE OFFLINE，, 这 条 广播 就 是 用 于 通知 程序 

强制 用 户 下 线 的。 也 就 是 说 ， 强制 用 户 下 线 的 逻辑 并 不 是 写 在 MainActivity 里 的 ,而 是 应 该 写 

在 接收 这 条 广播 的 BroadcastReceiver 里 。 这 样 强 制 下 线 的 功能 就 不 会 依附 于 任何 界面 了 ，, 不 
管 是 在 程序 的 任何 地 方 ， 只 要 发 出 这 样 一 条 广播 ， 就 可 以 完成 强制 下 线 的 操作 了 。 


那么 毫 无 疑问 ， 接 下 来 我 们 就 需要 创建 一 个 BroadcastReceiver 来 接收 这 条 强制 下 线 广播 。 唯 
一 的 问题 就 是 , 应 该 在 哪里 创建 呢 ? 由 于 BroadcastReceiver 中 需要 弹出 一 个 对 话 框 来 阻塞 用 
户 的 正常 操作 ， 但 如 果 创 建 的 是 一 个 静态 注册 的 BroadcastReceiver， 是 没有 办 法 在 
onReceive() 方 法 里 弹出 对 话 框 这 样 的 UI 控件 的 ， 而 我 们 显然 也 不 可 能 在 每 个 Activity 中 都 注 
册 一 个 动态 的 BroadcastReceiver。 


那么 到 底 应 该 怎么 办 呢 ? 答案 其 实 很 明显 ， 只 需要 在 BaseActivity 中 动态 注册 一 个 
BroadcastReceiver 就 可 以 了 ， 因 为 所 有 的 Activity 都 继承 自 BaseActivity。 


修改 BaseActivity 中 的 代码 ， 如 下 所 示 : 


open class BaseActivity : AppCompatActivity() { 
Lateinit var receiver: Force0ffLineReceiver 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
ActivityCollector.addActivity(this) 

} 


override fun onResume() { 
super.onResume() 
val intentFilter = IntentFilter() 
intentFilter.addAction("com.example.broadcastbestpractice.FORCE OFFLINE") 
receiver = Force0fflineReceiver() 
registerReceiver(receiver, intentFilter) 


} 


override fun onPause() { 
super.onPause() 
unregisterReceiver(receiver) 


override fun onDestroy() { 
super.onDestroy() 
ActivityCollector.removeActivity(this) 


} 
inner class ForceOfflineReceiver : BroadcastReceiver() { 
override fun onReceive(context: Context, intent: Intent) { 


AlertDialog.Builder(context).apply { 
setTitle("Warning") 
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SetMessage("You are forced to be offline. Please try to Login again.") 
setCancelable(false) 
setPositiveButton("OK") { ， -> 
Act Dv lyeol leeton finishALL() // 销毁 所 有 Activity 
val i = Intent(context, LoginActivity::class.java) 
context.startActivity(i) // 重新 启动 LoginActivity 


show() 


} 


先 来 看 一 下 ForceOfflineReceiver 中 的 代码 ， 这 次 onReceive( ) 方 法 里 可 不 再 是 仅仅 弹出 一 个 
Toast 了 , 而 是 加 入 了 较 多 的 代码 ， 那 我 们 就 来 仔细 看 看 吧 。 首 先是 使 用 AlertDialog.Builder 
构建 一 个 对 话 框 。 注 意 ， 这 里 一 定 要 调用 setCancelable() 方 法 将 对 话 框 设 为 不 可 取消 ，, 否 
则 用 户 按 一 下 Back 键 就 可 以 关闭 对 话 框 继续 使 用 程序 了 。 然 后 使 用 setPositiveButton() 方 
法 给 对 话 框 注册 确定 按钮 ， 当 用 户 点 击 了 “OK" 按 钮 时 ， 就 调用 ActivityCollector 的 
finishAll() 方 法 销毁 所 有 Activity ,并 重新 启动 LoginActivity。 


再 来 看 一 下 我 们 是 怎么 注册 ForceOfflineReceiver 这 个 BroadcastReceiver 的 。 可 以 看 到 ， 
里 重 写 了 onResume ( ) 和 onPause( ) 这 两 个 生命 周期 方法 ， 然后 分 别 在 这 两 个 方法 里 注册 和 取 
消 注 册 了 ForceOfflineReceiver。 


为 什么 要 这 样 写 呢 ? 之 前 不 都 是 在 onCreate() 和 onDest roy( ) 方 法 里 注册 和 取消 注册 
BroadcastReceiver 的 吗 ? 这 是 因为 我 们 始终 需要 保证 只 有 处 于 栈 顶 的 Activity 才 能 接收 到 这 

条 强制 下 线 广播 ， 非 栈 顶 的 Activity 不 应 该 也 没 必要 接收 这 条 广播 ， 所 以 写 在 onResume ( ) 和 
onPause () 方 法 里 就 可 以 很 好 地 解决 这 个 问题 ， 当 一 个 Activity 失 去 栈 顶 位 置 时 就 会 自动 取消 
BroadcastReceiver 的 注册 。 


这 样 的 话 ， 所 有 强制 下 线 的 逻辑 就 已 经 完成 了 ， 接 下 来 我 们 还 需要 对 AndroidManifest.xmI 文 
件 进 行 修改 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcastbestpractice"> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity android:name=".LoginActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN"/> 
<category android:name="android.intent.category.LAUNCHER"/> 
</intent-filter> 
</activity> 


<activity android:name=".MainActivity"> 
</activity> 
</application> 
</manifest> 
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这 里 只 需要 对 一 处 代码 进行 修改 ， 就 是 将 主 Activity 设 置 为 LoginActivity， 而 不 再 是 
MainActivity， 因 为 你 肯定 不 希望 用 户 在 没 登录 的 情况 下 就 能 直接 进入 程序 主 界面 吧 ? 

好 了 ， 现在 来 尝试 运行 一 下 程序 吧 。 首 先 会 进入 登录 界面 ， 并 可 以 在 这 里 输入 账号 和 密码 ， 如 
图 6.9 所 示 。 


10:42 


BroadcastBestPractice 


Account: admin 


LOGIN 


图 6.9 ”登录 界面 


如 果 输 入 的 账号 是 admin , 密码 是 123456 , 点 击 登录 按钮 就 会 进入 程序 的 主 界面 , 如 图 6.10 
所 示 。 这 时 点 击 一 下 发 送 广播 的 按钮 ， 就 会 发 出 一 条 强制 下 线 的 广播 ，ForceOfflineReceiver 
收 到 这 条 广播 后 会 弹出 一 个 对 话 框 ， 提 示 用 户 已 被 强制 下 线 ， 如 图 6.11 所 示 。 
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BroadcastBestPractice 


SEND FORCE OFFLINE BROADCAST 


图 6.10 ” 主 界 面 
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Warning 
You are forced to be offline. Please try to 


login again. 


OK 


图 6.11 强制 下 线 提示 


这 时 用 户 将 无 法 再 对 界面 的 任何 元 素 进行 操作 ， 只 能 点 击 "OK" 按 钮 ， 然 后 重新 回 到 登录 界面 。 
这 样 ， 强 制 下 线 功能 就 完整 地 实现 了 。 


结束 了 本 章 的 最 佳 实践 部 分 ， 接 下 来 又 要 进入 我 们 本 章 的 Kotlin 课 堂 了 。 
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6.5 Kotlin 课 堂 : 高 阶 函 数 详解 


学 到 这 里 ， 你 已 经 可 以 算是 完全 入 门 Kotlin 编 程 了 。 因 此 ， 从 本 章 的 Kotlin 课 堂 起 ， 我们 就 将 告 
别 基础 知识 ， 开 始 转 向 Kotlin 的 高 级 用 法 ， 从 而 进一步 提升 你 的 Kotlin 水 平 。 


那么 就 从 高 阶 函 数 开始 吧 。 
6.5.1 定义 高 阶 函 数 


高 阶 郧 数 和 Lambda 的 关系 是 密 不 可 分 的 。 在 第 2 章 快 速 入 门 Kotlin 编 程 的 时 候 ， 我们 已 经 学 习 
了 Lambda 编 程 的 基础 知识 ， 并 且 掌 握 了 一 些 与 集合 相关 的 函数 式 API 的 用 法 ， 如 map、 

filter 哆 数 等 。 另 外 ,在 第 3 章 的 Kotlin 课 党 中， 我 们 又 学 习 了 Kotlin 的 标准 限 数 ， 如 run.、 
appLy 顺 数 等 。 


你 有 没有 发 现 ， 这 几 个 冰 数 有 一 个 共同 的 特点 : 它们 都 会 要 求 我 们 传 入 一 个 Lambda 表 达 式 作 

为 参数 。 像 这 种 接收 Lambda 参 数 的 函数 就 可 以 称 为 具 用 数 式 编程 风格 的 API ,而 如 果 你 想 要 
定义 自己 的 少数 式 AP1， 那 就 得 借助 高 阶 水 数 来 实现 了 ， 这 也 是 我 们 本 节 Kotlin 课 党 所 要 重点 学 
习 的 内 容 。 


首先 来 看 一 下 高 阶 了 水 数 的 定义 。 如 果 一 个 少数 接收 另 一 个 函数 作为 参数 ， 或 者 返回 值 的 类 型 是 
另 一 个 函数 ， 那 么 该 函数 就 称 为 高 阶 函 数 。 


这 个 定义 可 能 有 点 不 太 好 理解 ， 一 个 水 数 怎么 能 接收 男 一 个 水 数 作为 参数 呢 ? 这 就 涉及 另外 一 
个 概念 了 : 函数 类 型 。 我 们 知道 ， 编 程 语言 中 有 整 型 、 布 尔 型 等 字段 类 型 ， 而 Kotlin 又 增加 了 一 
个 消 数 类 型 的 概念 。 如 果 我 们 将 这 种 削 数 类 型 添加 到 一 个 溪 数 的 参数 声明 或 者 返回 值 声明 当 

中 ， 那 么 这 就 是 一 个 高 阶 函 数 了 。 


接 下 来 我 们 就 学 习 一 下 如 何 定义 一 个 函数 类 型 。 不 同 于 定义 一 个 普通 的 字段 类 型 ， 冰 数 类 型 的 
语法 规则 是 有 点 特殊 的 ， 基 本 规则 如 下 : 


(String, Int) -> Unit 


突然 看 到 这 样 的 语法 规则 ， 你 一 定 一 头 雾 水 吧 ? 不 过 不 用 担心 ， 耐 心 听 完 我 的 解释 之 后 ， 你 就 
能 够 轻松 理解 了 。 


既然 是 定义 一 个 函数 类 型 ， 那 么 最 关键 的 就 是 要 声明 该 永 数 接收 什么 参数 ， 以 及 它 的 返回 值 是 
什么 。 因 此 ，- > 左边 的 部 分 就 是 用 来 声明 该 函数 接收 什么 参数 的 ， 多 个 参数 之 间 使 用 逗号 隔 
开 ， 如 果 不 接收 任何 参数 ， 写 一 对 空 括号 就 可 以 了 。 而 -> 右边 的 部 分 用 于 声明 该 冰 数 的 返回 值 
是 什么 类 型 ， 如 果 没 有 返回 值 就 使 用 Unit，, 它 大 致 相当 于 Java 中 的 void。 


现在 将 上 述 函数 类 型 添加 到 某 个 函数 的 参数 声明 或 者 返回 值 声明 上 ， 那么 这 个 函数 就 是 一 个 高 
阶 吨 数 了 ， 如 下 所 示 : 


fun example(func: (String, Int) -> Unit) { 
func("hello", 123) 
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可 以 看 到 ,这 里 的 examptLe ( ) 函数 接收 了 一 个 函数 类 型 的 参数 ,因此 exampte ( ) 级 数 就 是 一 个 
高 阶 函 数 。 而 调用 一 个 函数 类 型 的 参数 ， 它 的 语法 类 似 于 调用 一 个 普通 的 函数 ， 只 需要 在 参数 
名 的 后 面 加 上 一 对 括号 ， 并 在 括号 中 传 入 必要 的 参数 即 可 。 


现在 我 们 已 经 了 解 了 高 阶 邹 数 的 定义 方式 ， 但 是 这 种 函数 具体 有 什么 用 途 呢 ? 由 于 高 阶 函 数 的 
用 途 实 在 是 太 广 泛 了 ， 这 里 如 果 要 让 我 简单 概括 一 下 的 话 ， 那 就 是 高 阶 消 数 人 允许 让 水 数 类 型 的 
参数 来 决定 函数 的 执行 逻辑 。 即 使 是 同一 个 高 阶 函 数 ， 只 要 传 入 不 同 的 函数 类 型 参数 ， 那 么 它 
的 执行 逻辑 和 最 终 的 返回 结果 就 可 能 是 完全 不 同 的 。 为 了 详细 说 明 这 一 点 ， 下 面 我 们 来 举 一 个 
具体 的 例子 。 


这 里 我 准备 定义 一 个 叫 作 num1AndNum2( ) 的 高 阶 函数 ， 并 让 它 接收 两 个 整 型 和 一 个 水 数 类 型 的 
参数 。 我 们 会 在 num1AndNum2 ( ) 函数 中 对 传 入 的 两 个 整 型 参数 进行 某 种 运算 ， 并 返回 最 终 的 运 
算 结果 ,但 是 具体 进行 什么 运算 是 由 传 入 的 溺 数 类 型 参数 决定 的 。 


新 建 一 个 HigherOrderFunction.kt 文 件 , 然后 在 这 个 文件 中 编写 如 下 代码 : 


fun numlAndNum2 (numl: Int, num2: Int, operation: (Int, Int) -> Int): Int { 
val result = operation(numl, num2) 
return result 


} 


这 是 一 个 非常 简单 的 高 阶 函 数 ， 可 能 它 并 没有 多 少 实际 的 意义 ， 却 是 个 很 好 的 学 习 示 例 。 
numlAndNum2 ( ) 水 数 的 前 两 个 参数 没有 什么 需要 解释 的 ， 第 三 个 参数 是 一 个 接收 两 个 整 型 参数 
并 且 返 回 值 也 是 整 型 的 前 数 类 型 参数 。 在 num1AndNum2 ( ) 也 数 中 ， 我 们 没有 进行 任何 具体 的 运 
算 操 作 ,而 是 将 num1l 和 num2 参 数 传 给 了 第 三 个 阴 数 类 型 参数 ， 并 获取 它 的 返回 值 ， 最 终 将 得 到 
的 返回 值 返 回 。 


现在 高 阶 六 数 已 经 定义 好 了 ， 那 么 我 们 该 如 何 调用 它 呢 ? 由 于 num1AndNumz2 ( ) 邹 数 接收 一 个 范 
数 类 型 的 参数 ， 因 此 我 们 还 得 先 定义 与 其 函数 类 型 相 匹配 的 函数 才 行 。 在 
HigherOrderFunction.kt 文 件 中 添加 如 下 代码 : 


fun plus(numl: Int，num2: Int): Int { 
return numl + num2 
} 


fun minus(numl: Int, num2: Int): Int { 
return numl - num2 


} 


这 里 定义 了 两 个 衣 数 ， 并 且 这 两 个 函数 的 参数 声明 和 捞 回 值 声明 都 和 numlAndNum2 ( ) 闻 数 中 的 
级 数 类 型 参数 是 完全 匹配 的 。 其 中 , pLus ( ) 函数 将 两 个 参数 相 加 并 返回 ，minus ( ) 函数 将 两 个 
参数 相 减 并 返回 ， 分 别 对 应 了 两 种 不 同 的 运算 操作 。 


有 了 上 述 函 数 之 后 ， 我 们 就 可 以 调用 numlAndNum2 ( ) 函 数 了 ,在 main( ) 范 数 中 编写 如 下 代 
但 : 


fun main() { 
val numl = 100 
val num2 = 80 
val resultl1 = numlAndNum2 (numl, num2, ::plus) 
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val result2 = numlAndNum2(numl, num2, ::minus) 
printLn("resuLt1 is $result1") 
println("result2 is $result2") 


注意 这 里 调用 num1AndNum2 ( ) 函数 的 方式 ， 第 三 个 参数 使 用 了 : :plus 和 : :minus 这 种 与 法 。 
这 是 一 种 函数 引用 方式 的 写法 ， 表 示 将 plus ( ) 和 minus ( ) 函数 作为 参数 传递 给 

numlAndNum2 ( ) 水 数 。 而 由 于 numlAndNum2( ) 消 数 中 使 用 了 传 入 的 消 数 类 型 参数 来 决定 具体 
的 运算 逻辑 ,因此 这 里 实际 上 就 是 分 别 使 用 了 plus( ) 和 minus ( ) 哨 数 来 对 两 个 数字 进行 运算 。 


现在 运行 一 下 程序 ， 结果 如 图 6.12 所 示 。 


Run: © com.example.uibestpractice.HigherOrde... 

p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
result1 is 180 

result2 is 20 


| Process finished with exit code 0 
图 6.12， 高 阶 函数 的 运行 结果 
这 和 我 们 预期 的 结果 是 一 致 的 。 


使 用 这 种 函数 引用 的 写法 虽然 能 够 正常 工作 ， 但 是 如 果 每 次 调用 任何 高 阶 函 数 的 时 候 都 还 得 先 
定义 一 个 与 其 闸 数 类 型 参数 相 匹 配 的 亢 数 ， 这 是 不 是 有 些 太 复杂 了 ? 


没 错 ， 因 此 Kotlin 还 支持 其 他 多 种 方式 来 调用 高 阶 函 数 ， 比 如 Lambda 表 达 式 、 匿 名 困 数 、 成 员 
引用 等 。 其 中 ，Lambda 表 达 式 是 最 常见 也 是 最 普遍 的 高 阶 消 数 调用 方式 ， 也 是 我 们 接 下 来 要 
重点 学 习 的 内 容 。 


上 述 代码 如 果 使 用 Lambda 表 达 式 的 写法 来 实现 的 话 ， 代 码 如 下 所 示 : 


fun main() { 
val numl = 100 
val num2 = 80 
val resultl1 = numlAndNum2(numl, num2) { nl1l, n2 -> 
nl + n2 
} 


val result2 = numlAndNum2(numl, num2) { nl1l, n2 -> 
nl - n2 


} 

println("resultl1 is $result1") 

println("result2 is $result2") 
} 


Lambda 表 达 式 的 语法 规则 我 们 在 2.6.2 小 节 已 经 学 习 过 了 ， 因 此 这 段 代 码 对 于 你 来 说 应 该 不 难 
理解 。 你 会 发 现 ，Lambda 表 达 式 同样 可 以 完整 地 表达 一 个 函数 的 参数 声明 和 返回 值 声 明 
(Lambda 表 达 式 中 的 最 后 一 行 代码 会 自动 作为 返回 值 ) ， 但 是 写法 却 更 加 精简 。 


现在 你 就 可 以 将 刚才 定义 的 pLus ( ) 和 minus ( ) 明 数 删 掉 了 ， 重 新 运行 一 下 代码 ， 你 会 发 现 结果 
是 一 模 一 样 的 。 
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下 面 我 们 继续 对 高 阶 函 数 进行 探究 。 回 顾 之 前 在 第 3 章 学 习 的 appLy 函 数 , 它 可 以 用 于 给 
Lambda 表 达 式 提供 一 个 指定 的 上 下 文 ， 当 需要 连续 调用 同一 个 对 象 的 多 个 方法 时 ， apptLy 子 
数 可 以 让 代码 变 得 更 加 精简 ,比如 StringBuitLder 就 是 一 个 典型 的 例子 。 接 下 来 我 们 就 使 用 高 
阶 范 数 模仿 实现 一 个 类 似 的 功能 。 


修改 HigherOrderFunction.kt 文 件 , 在 其 中 加 入 如 下 代码 : 


fun StringBuilder.build(block: StringBuilder.() -> Unit): StringBuilder { 
block() 
return this 


} 


这 里 我 们 给 StringBuiLder 类 定义 了 一 个 buiLd 扩 展 函 数 , 这 个 扩展 函数 接收 一 个 函数 类 型 参 
数 , 并 且 返 回 值 类 型 也 是 StringBuiLder。 

注意 ,这 个 函数 类 型 参数 的 声明 方式 和 我 们 前 面 学 习 的 语法 有 所 不 同 : 它 在 函数 类 型 的 前 面 加 
上 了 一 个 StringBuilder. 的 语法 结构 。 这 是 什么 意思 呢 ? 其 实 这 才 是 定义 高 阶 函数 完整 的 语 
法 规则 ,在 函数 类 型 的 前 面 加 上 ClassName. 就 表示 这 个 函数 类 型 是 定义 在 哪个 类 当中 的 。 


那么 这 里 将 函数 类 型 定义 到 StringBuiLder 类 当中 有 什么 好 处 呢 ?好 处 就 是 当 我 们 调用 build 
明 数 时 传 入 的 Lambda 表 达 式 将 会 自动 拥有 StringBuitLder 的 上 下 文 ， 同 时 这 也 是 appLy 池 数 
的 实现 方式 。 


现在 我 们 就 可 以 使 用 自己 创建 的 buiLd 函 数 来 简化 StringBuiLder 构 建 字符 串 的 方式 了 。 这 里 
仍然 用 吃水 果 这 个 功能 来 举例 : 


fun main() { 
val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
val result = StringBuilder().build { 
append("Start eating fruits.\n") 
for (fruit in list) { 
append (fruit).append("\n") 


append("Ate all fruits.") 


println(result.toString()) 


} 


可 以 看 到 ，buitLd 函 数 的 用 法 和 apptLy 函 数 基本 上 是 一 模 一 样 的 ， 只 不 过 我 们 编写 的 buiLd 函 
数目 前 只 能 作用 在 StringBuiLder 类 上 面 , 而 appLy 函 数 是 可 以 作用 在 所 有 类 上 面 的 。 如 果 想 
实现 appLy 函 数 的 这 个 功能 ， 需 要 借助 于 Kotlin 的 泛 型 才 行 ， 我 们 将 在 第 8 章 学 习 泛 型 的 相关 内 
现在 ， 你 已 经 完全 掌握 了 高 阶 函 数 的 基本 功能 ， 接 下 来 我 们 要 学 习 一 些 更 加 高 级 的 知识 。 
6.5.2 ”内 联 函数 的 作用 

高 阶 函数 确实 非常 神奇 ， 用途 也 十 分 广泛 ， 可 是 你 知道 它 背 后 的 实现 原理 是 怎样 的 吗 ? 当然 ， 


这 个 话题 并 不 要 求 每 个 人 都 必须 了 解 ， 但 是 为 了 接 下 来 可 以 更 好 地 理解 内 联 消 数 这 个 知识 点 ， 
我 们 还 是 简单 分 析 一 下 高 阶 函 数 的 实现 原理 。 
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这 里 仍然 使 用 刚才 编写 的 numlAndNum2 ( ) 少数 来 举例 ,代码 如 下 所 示 : 


fun numlAndNum2 (numl: Int, num2: Int，operation: (Int, Int) -> Int): Int { 
val result = operation(numl, num2) 
return result 


} 


fun main() { 
val numl = 100 
val num2 = 80 
val result = numlAndNum2 (numl, num2) { nl1l, n2 -> 
nl + n2 
} 


} 


可 以 看 到 ,上 述 代码 中 调用 了 num1lAndNum2( ) 组 数 ， 并 通过 Lambda 表 达 式 指定 对 传 入 的 两 个 
整 型 参数 进行 求 和 。 这 段 代码 在 Kotlin 中 非常 好 理解 ， 因为 这 是 高 阶 函数 最 基本 的 用 法 。 可 是 我 
们 都 知道 ，Kotlin 的 代码 最 终 还 是 要 编译 成 java 字 节 码 的 ， 但 Java 中 并 没有 高 阶 函 数 的 概念 。 


那么 Kotlin 究 竟 使 用 了 什么 魔法 来 让 Java 支持 这 种 高 阶 函 数 的 语法 呢 ? 这 就 要 归功 于 Kotlin 强 大 
的 编译 器 了 。Kotlin 的 编译 问 会 将 这 些 高 阶 函 数 的 语法 转换 成 java 支 持 的 语法 结构 ， 上 述 的 
Kotlin 代 码 大 致 会 被 转换 成 如 下 java 代 码 : 


public static int numlAndNum2(int numl, int num2, Function operation) { 
int result = (int) operation.invoke(numl, num2); 
return result; 


} 


public static void main() { 
int numl = 100; 
int num2 = 80; 
int result = numlAndNum2 (numl, num2, new Function() { 
@Override 
public Integer invoke(Integer nl1, Integer n2) { 
return nl + n2; 


}); 


} 


考虑 到 可 读 性 ,我 对 这 上段 代码 进行 了 些许 调整 ， 并 不 是 严格 对 应 了 Kotlin 转 换 成 的 J]ava 代 码 。 可 
以 看 到 ， 在 这 里 numlAndNum2 ( ) 销 数 的 第 三 个 参数 变 成 了 一 个 Function 接 口 ,这 是 一 种 
Kotlin 内 置 的 接口 ， 里 面 有 一 个 待 实现 的 invoke ( ) 函 数 。 而 numlAndNum2 ( ) 汤 数 其 实 就 是 调 
用 了 Function 接 口 的 invoke() 上 名 数 ， 并 把 num1 和 num2 参 数 传 了 进去 。 


在 调用 num1AndNum2 ( ) 函数 的 时 候 ,之 前 的 Lambda 表 达 式 在 这 里 变 成 了 Function 接 口 的 匿 
名 类 实现 ， 然 后 在 invoke ( ) 函数 中 实现 了 n1 + n2 的 逻辑 ， 并 将 结果 返回 。 

这 就 是 Kotlin 高 阶 函 数 背 后 的 实现 原理 。 你 会 发 现 ， 原 来 我 们 一 直 使 用 的 Lambda 表 达 式 在 底层 
被 转换 成 了 匿名 类 的 实现 方式 。 这 就 表明 ， 我们 每 调用 一 次 Lambda 表 达 式 ， 都 会 创建 一 个 新 
的 匿名 类 实例 ， 当然 也 会 造成 额外 的 内 存 和 性 能 开销 。 


为 了 解决 这 个 问题 ，Kotlin 提 供 了 内 联 函数 的 功能 ， 它 可 以 将 使 用 Lambda 表 达 式 带 来 的 运行 时 
开销 完全 消除 。 
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内 联 嚼 数 的 用 法 非常 简单 ,只 需要 在 定义 高 阶 函数 时 加 上 :intLine 关 键 字 的 声明 即 可 , 如 下 所 
示 : 


inline fun numlAndNum2 (numl: Int, num2: Int, operation: (Int, Int) -> Int): Int { 
val result = operation(numl, num2) 
return result 


上 
那么 内 联盟 数 的 工作 原理 又 是 什么 呢 ? 其 实 并 不 复杂 ,就 是 Kotlin 编 译 兹 会 将 内 联 水 数 中 的 代码 
在 编译 的 时 候 自动 替换 到 调用 它 的 地 方 ， 这 样 也 就 不 存在 运行 时 的 开销 了 。 

当然 ， 仅 仅 一 名 话 的 描述 可 能 还 是 让 人 不 太 容 易 理解 ， 下 面 我 们 通过 图 例 的 方式 来 详细 说 明 内 
联 函 数 的 代码 替换 过 程 。 

首先 ，Kotlin 编 译 器 会 将 Lambda 表 达 式 中 的 代码 替换 到 消 数 类 型 参数 调用 的 地 方 ， 如 图 6.13 
所 未。 


inline fun numlAndNum2(numl: Int, num2: Int, operation: (Int, Int) -> Int): Int { 


val result =|operation(num1l， num2) | 


return result 


} 


fun main() { 
val numl = 100 
val num2 = 80 
val result = numlAndNum2(numl, num2) { nl, n2 -> 


} 
} 


图 6.13 第 一 步 蔡 换 过 程 
接 下 来 ， 再 将 内 联 函 数 中 的 全 部 代码 替换 到 函数 调用 的 地 方 ， 如 图 6.14 所 示 。 


inLine fun numlAndNum2(numl: Int, num2: Int): Int { 
val result = numl + num2 


return result 


} 


fun main() { 
val numl = 100 
val num2 = 80 


val result = |numlAndNum2(numl, num2) 


} 
图 6.14 第 二 步 震 换 过 程 
最 终 的 代码 就 被 替换 成 了 如 图 6.15 所 示 的 样子 。 
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fun main() { 
val numl = 100 


val num2 = 80 


vat result = (numl + num2] 


} 
图 6.15 最 终 的 替换 结果 
也 正 是 如 此 ,内 联 函 数 才能 完全 消除 Lambda 表 达 式 所 带 来 的 运行 时 开销 。 
6.5.3 noinLine 与 crossinLine 
接 下 来 我 们 要 讨论 一 些 更 加 特殊 的 情况 。 比 如 ， 一 个 高 阶 郧 数 中 如 果 接 收 了 两 个 或 者 更 多 项 数 
类 型 的 参数 ， 这 时 我 们 给 函数 加 上 了 inLine 关 键 子 ， 那 么 Kotlin 编 译 问 会 自动 将 所 有 引用 的 
Lambda 表 达 式 全 部 进行 内 联 。 


但 是 ， 如果 我 们 只 想 内 联 其 中 的 一 个 Lambda 表 达 式 该 怎么 办 呢 ? 这 时 就 可 以 使 用 noinLine 关 
刍 字 了 ， 如 下 所 示 : 


inline fun inlineTest(blockl: () -> Unit, noinline block2: () -> Unit) { 


可 以 看 到 ,这 里 使 用 inLine 关 键 字 声明 了 inLineTest() 函 数 , 原本 bLock1 和 btLock2 这 两 
个 函数 类 型 参数 所 引用 的 Lambda 表 达 式 都 会 被 内 联 。 但 是 我 们 在 bLock2 参 数 的 前 面 双 加 上 了 
一 个 noinLine 关 键 字 ,那么 现在 就 只 会 对 bLock1 参 数 所 引用 的 Lambda 表 达 式 进行 内 联 了 。 

这 就 是 noinLine 关 键 字 的 作用 。 


前 面 我 们 已 经 解释 了 内 联 函 数 的 好 处 ， 那 么 为 什么 Kotlin 还 要 提供 一 个 noinLine 关 键 字 来 排除 
内 联 功能 呢 ? 这 是 因为 内 联 的 函数 类 型 参数 在 编译 的 时 候 会 被 进行 代码 蔡 换 ， 因 此 它 没有 真正 
的 参数 属性 。 非 内 联 的 涵 数 类 型 参数 可 以 自由 地 传递 给 其 他 任何 水 数 ， 因 为 尼 就 是 一 个 真实 的 
参数 ， 而 内 联 的 函数 类 型 参数 只 允许 传递 给 另外 一 个 内 联 函 数 ,这 也 是 它 最 大 的 局 限 性 。 


男 外 ， 内 联 肖 数 和 非 内 联 消 数 还 有 一 个 重要 的 区 别 ， 那 就 是 内 联 消 数 所 引用 的 Lambda 表 达 式 
中 是 可 以 使 用 return 关 键 字 来 进行 函数 返回 的 ， 而 非 内 联 函 数 只 能 进行 局 部 返回 。 为 了 说 明 这 
个 问题 ， 我 们 来 看 下 面 的 例子 。 


fun printString(str: String, block: (String) -> Unit) { 
println("printString begin") 
block(str) 
println("printString end") 


cd 
一 
1 


main() { 
println("main start") 
val str = "" 
printString(str) { s -> 
printLn("Lambda start") 
if (s.isEmpty()) return@printString 
println(s) 
printLn("Lambda end") 


println("main end") 
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这 里 定义 了 一 个 叫 作 printsString () 的 高 阶 函 数 , 用 于 在 Lambda 表 达 式 中 打印 传 入 的 字符 串 
参数 。 但 是 如 果 字 符 串 参数 为 空 ， 那 么 就 不 进行 打印 。 注 意 ，Lambda 表 达 式 中 是 不 允许 直接 
使 用 return 关 键 字 的 ， 这 里 使 用 了 returnGp rintString 的 写法 ， 表 示 进 行 局 部 返回 ， 并 且 
不 再 执行 Lambda 表 达 式 的 剩余 部 分 代码 。 


现在 我 们 就 刚好 传 入 一 个 空 的 字符 串 参 数 ， 运 行程 序 , 打印 结果 如 图 6.16 所 示 。 


Run: “com.example.broadcastbestpractice.Hig.…. 
p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
main start 


printString begin 
lambda start 
printString end 
main end 


le YJ 


Process finished with exit code 0 
图 6.16 局 部 返回 的 运行 结果 


可 以 看 到 ,除了 Lambda 表 达 式 中 returnGprintString 语 名 之 后 的 代码 没有 打印 ， 其 他 的 日 
志 是 正常 打印 的 ， 说 明 returnG@printString 确 实 只 能 进行 局 部 返回 。 


但 是 如 果 我 们 将 printString() 函 数 声明 成 一 个 内 联盟 数 ， 那 么 情况 就 不 一 样 了 ， 如 下 所 示 : 


inline fun printString(str: String, block: (String) -> Unit) { 
println("printString begin") 
block(str) 
println("printString end") 


fun main() { 

println("main start") 

val str = "" 

printString(str) { s -> 
printLn("Lambda start") 
if (s.isEmpty()) return 
println(s) 
printLn("Lambda end") 


println("main end") 


现在 printString() 了 水 数 变 成 了 内 联 了 水 数 ,我 们 就 可 以 在 Lambda 表 达 式 中 使 用 return 关 键 
字 了 。 此 时 的 return 代 表 的 是 返回 外 层 的 调用 函数 ， 也 就 是 nain( ) 范 数 ， 如 果 想 不 通 为 什么 
的 话 ， 可 以 回顾 一 下 在 上 一 小 节 中 学 习 的 内 联 函 数 的 代码 蔡 换 过 程 。 


现在 重新 运行 一 下 程序 , 打印 结果 如 图 6.17 所 示 。 


Run: °° com.example.broadcastbestpractice.Hig... 

p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
main start 

printString begin 

lambda start 


Process finished with exit code 0 


le dl 
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图 6.17 非 局 部 返回 的 运行 结果 


可 以 看 到 , 不 管 是 main( ) 函 数 还 是 printSstring () 函 数 ， 确 实 都 在 return 关 键 字 之 后 停止 
执行 了 ， 和 我 们 所 预期 的 结果 一 致 。 


将 高 阶 函 数 声明 成 内 联 函 数 是 一 种 良好 的 编程 习惯 ， 事 实 上 ， 绝 大 多 数 高 阶 函 数 是 可 以 直接 声 
明成 内 联 函 数 的 ， 但 是 也 有 人 少 部 分 例外 的 情况 。 观 察 下 面 的 代码 示例 : 


inLine fun runRunnable(block: () -> Unit) { 
val runnable = Runnable { 
block() 


runnable.run() 


这 段 代 码 在 没有 加 上 inline 关 键 字 声明 的 时 候 绝对 是 可 以 正常 工作 的 ， 但 是 在 加 上 inline 关 
键 字 之 后 就 会 提示 如 图 6.18 所 示 的 错误 。 
inline fun runRunnable(block: () -> Unit) { 
val runnable = Runnable { 
block() 


1 
Can't inline 'block' here: it may contain non-local returns. Add 'crossinline' modifier to parameter declaration 'block' 


图 6.18 使 用 内 联 函 数 可 能 出 现 的 错误 


这 个 错误 出 现 的 原因 解释 起 来 可 能 会 稍微 有 点 复杂 。 首 先 ， 在 runRunnabte ( ) 函数 中 ， 我 们 创 
建 了 一 个 Runnable 对 象 ， 并 在 Runnable 的 Lambda 表 达 式 中 调用 了 传 入 的 函数 类 型 参数 。 而 
Lambda 表 达 式 在 编译 的 时 候 会 被 转换 成 匿名 类 的 实现 方式 ， 也 就 是 说 ， 上述 代 码 实际 上 是 在 
匿名 类 中 调用 了 传 入 的 函数 类 型 参数 。 


而 内 联 函 数 所 引用 的 Lambda 表 达 式 允许 使 用 return 关 键 字 进行 函数 返回 ， 但 是 由 于 我 们 是 在 
匿名 类 中 调用 的 函数 类 型 参数 ， 此 时 是 不 可 能 进行 外 层 调 用 冰 数 返回 的 ， 最 多 只 能 对 匿名 类 中 
的 水 数 调 用 进行 返回 ， 因 此 这 里 就 提示 了 上 述 错误 。 


也 就 是 说 ， 如 果 我 们 在 高 阶 函数 中 创建 了 另外 的 Lambda 或 者 匿名 类 的 实现 ， 并 且 在 这 些 实现 
中 调用 函数 类 型 参数 ， 此 时 再 将 高 阶 冰 数 声明 成 内 联 函 数 ， 就 一 定 会 提示 错误 。 


那么 是 不 是 在 这 种 情况 下 就 真 的 无 法 使 用 内 联 吸 数 了 呢 ? 也 不 是 ， 比 如 借助 crossinLine 关 键 
字 就 可 以 很 好 地 解决 这 个 问题 : 


inLine fun runRunnable(crossinline block: () -> Unit) { 
val runnable = Runnable { 
block() 


runnable. run() 


可 以 看 到 ,这 里 在 函数 类 型 参数 的 前 面 加 上 了 crossintLine 的 声明 ,代码 就 可 以 正常 编译 通过 
四 
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那么 这 个 crossinLine 关 键 字 又 是 什么 呢 ? 前 面 我 们 已 经 分 析 过 ， 之 所 以 会 提示 图 6.18 所 示 的 
错误 ， 就 是 因为 内 联 函 数 的 Lambda 表 达 式 中 人 允许 使 用 retu rn 关键 字 ， 和 高 阶 郧 数 的 匿名 类 实 
现 中 不 允许 使 用 return 关 键 字 之 间 造 成 了 冲突 。 而 crossinLine 关 键 字 就 像 一 个 契约 ， 它 用 
于 保证 在 内 联 函 数 的 Lambda 表 达 式 中 一 定 不 会 使 用 return 关 键 字 ， 这 样 冲突 就 不 存在 了 ， 问 
题 也 就 巧妙 地 解决 了 。 


声明 了 crossinLine 之 后 ,我 们 就 无 法 在 调用 runRunnabtLe 函 数 时 的 Lambda 表 达 式 中 使 用 
return 关 键 字 进行 函数 返回 了 ， 但 是 仍然 可 以 使 用 return@runRunnable 的 写法 进行 局 部 返 
回 。 总 体 来 说 ， 除 了 在 return 关 键 字 的 使 用 上 有 所 区 别 之 外 , crossinLine 保 留 了 内 联 函 数 
的 其 他 所 有 特性 。 


好 了 “， 以 上 就 是 关于 高 阶 函 数 的 几乎 所 有 的 重要 内 容 ， 希 望 你 能 将 这 些 内 容 好 好 掌握 , 因为 后 
面 与 Lambda 以 及 高 阶 孙 数 相关 的 很 多 知识 是 建立 在 本 节 课 堂 的 基础 之 上 的 。 


结束 了 本 章 的 Kotlin 课 堂 ， 接 下 来 我 们 要 进入 一 个 特殊 的 环节 。 相 信 你 一 定 知道 ， 很 多 出 色 的 项 
目 并 不 是 由 一 个 人 单枪匹马 完成 的 ， 而 是 由 一 个 团队 共同 合作 开发 完成 的 。 这 个 时 候 多 人 之 间 
代码 同步 的 问题 就 显得 异常 重要 了 ， 因 此 版 本 控制 工具 也 就 应 运 而 生 。 常 见 的 版 本 控制 工具 主 
要 有 SVN 和 Git ,本 书 将 会 对 Git 的 使 用 方法 进行 全 面 的 讲解 ， 并 且 讲 解 的 内 容 是 穿插 于 一 些 章 
节 当 中 的 。 那 么 今天 ， 我 们 就 先 来 看 一 看 Git 最 基本 的 用 法 。 
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6.6 ”Git 时 间 : 初 识 版 本 控制 工具 


Git 是 一 个 开源 的 分 布 式 版 本 控制 工具 ， 它 的 开发 者 就 是 易 易 大 名 的 Linux 操 作 系统 的 作者 Linus 
Torvalds。Git 被 开发 出 来 的 初衷 是 为 了 更 好 地 管理 Linux 内 核 ， 而 现在 早已 被 广泛 应 用 于 全 球 

各 种 大 中 小 型 项 目 中 。 今 天 是 我 们 关于 Git 的 第 一 堂 课 ， 主 要 是 讲解 一 下 它 最 基本 的 用 法 ， 那 么 
就 从 安装 Git 开 始 吧 。 


6.6.1 安装 Git 


由 于 Git 和 Linux 操 作 系统 是 同一 个 作者 ， 因 此 不 用 我 说 ， 你 也 应 该 猿 到 Git 在 Linux 上 的 安装 是 
最 简单 方便 的 。 比 如 你 使 用 的 是 Ubuntu 系统 ， 只 需要 打开 终端 界面 ， 输 入 命令 Sudo apt-get 
install git，, 按 下 回 车 键 后 输入 密码 ， 即 可 完成 Git 的 安装 。 

Mac 系 统 是 类 似 的 ， 如 果 你 已 经 安装 了 Homebrew , 只 需要 在 终端 中 输入 命令 brew install 
git 即 可 完成 安装 。 

而 Windows 系 统 就 要 相对 麻烦 一 些 了 ， 我们 需要 先 下载 Git 的 安装 包 。 访 问 Git for Windows 官 
网 (https://gitforwindows.org/) ， 可 以 看 到 如 图 6.19 所 示 的 页 面 。 


2 
git for windows FAQ REPOSITORY MAILING LIST 


VERSION 2.24.0(2) 


We bring the 
awesome Git SCM to 


Windows 


图 6.19 Git for Windows 的 主页 

点 击 “Download” 按 钮 即 可 下 载 ， 下载 完 成 后 双击 安装 包 进 行 安装 ， 之 后 一 直 点 击 “ 下 一 步 " 就 
可 以 完成 安装 了 。 

6.6.2 创建 代码 仓库 


虽然 在 Windows 上 安装 的 Git 是 可 以 在 图 形 界面 上 进行 操作 的 ， 并 且 Android Studio 也 支持 以 

图 形 化 的 形式 操作 Git ,但 是 我 暂时 还 不 建议 你 这 样 做 ， 因 为 Git 的 各 种 命令 才 是 你 目前 应 该 掌握 
的 核心 技能 。 不 管 在 哪个 操作 系统 中 ， 使 用 命令 来 操作 Git 肯 定 是 通用 的 。 而 图 形 化 的 操作 应 该 

是 在 你 能 熟练 掌握 命令 用 法 的 前 提 下 ， 进 一 步 提 升 工作 效率 的 手段 。 
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那么 我 们 现在 就 来 党 试 一 下 通过 命令 来 使 用 Git。 如 有 果 你 使 用 的 是 Linux 或 Mac 系 统 ， 就 先 打开 
终端 界面 ; 如 果 使 用 的 是 Windows 系 统 ， 就 从 “开始 "里 找到 Git Bash 并 打开 。 


首先 配置 一 下 你 的 身份 ,这样 在 提交 代码 的 时 候 ，Git 就 可 以 知道 是 谁 提交 的 了 。 命 令 如 下 所 
不 : 


git config --global user.name "Tony" 
git config --global user.email "tony@gmail.com" 


配置 完成 后 ， 你 还 可 以 使 用 同样 的 命令 来 查看 是 否 配置 成 功 ， 只 需要 将 最 后 的 名 字 和 邮箱 地 址 
去 掉 即 可 ， 如 图 6.20 所 示 。 


guolindeMacBook-Pro:~ guolin$ git config --global user.name 
Tony 


guolindeMacBook-Pro:~ guolin$ git config --global user.email 
tony@gmail .com 
guolindeMacBook-Pro:~ guolin$ 


图 6.20 ”查看 Git 用 户 名 和 邮箱 


然后 我 们 就 可 以 开始 创建 代码 仓库 了 ， 仓库 (repository) 是 用 于 保存 版 本 管理 所 需 信息 的 地 
方 ， 所 有 本 地 提交 的 代码 都 会 被 提交 到 代码 仓库 中 ， 如 果 有 需要 还 可 以 推送 到 远程 仓库 中 。 


这 里 我 们 尝试 给 BroadcastBestPractice 项 目 建立 一 个 代码 仓库 。 先 进入 
BroadcastBestPractice 项 目的 目录 下 ， 如 图 6.21 所 示 。 


guolindeMacBook-Pro:~ guolin$ cd AndroidStudioProjects/AndroidFirstLine/BroadcastBestPractice/ 


guolindeMacBook-Pro:BroadcastBestPractice guolin$ 


图 6.21 切换 到 BroadcastBestPractice 项 目 目录 下 
然后 在 这 个 目录 下 面 输入 如 下 命令 : 


git init 


很 简单 吧 ! 只 需要 一 行 命令 就 可 以 完成 创建 代码 仓库 的 操作 ， 如 图 6.22 所 示 。 


guolindeMacBook-Pro:BroadcastBestPractice guolin$ git init 
Initialized empty Git repository in /Users/guolin/AndroidStudioProjects/AndroidFirstLine/BroadcastBestPractice/.git/ 


guolindeMacBook-Pro:BroadcastBestPractice guolin$ 


图 6.22 创建 代码 仓库 


仓库 创建 完成 后 ,会 在 BroadcastBestPractice 项 目的 根 目录 下 生成 一 个 隐藏 的 .git 目 录 ， 
目录 就 是 用 来 记录 本 地 所 有 的 Git 操 作 的 ， 可 以 通过 Ls -al 命令 查看 一 下 ， 如 图 6. 23 所 示 ， 
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guolindeMacBook-Pro:BroadcastBestPractice guolin$ ls -al 
total 72 

drwxr-xr-x 16 guolin staff 
drwxr-xr-x 16 guolin staff 
drwxr-xr-x 9 guolin staff 
-"W-r--r-- guolin staff 
drwxr-xr-x guolin staff 
drwxr-xr-x 11 guolin staff 
-rW-r--r-- guolin staff 
drwxr-xr-x guolin staff 
drwxr-xr-x guolin staff 
-rwW-r--r-- guolin staff 
drwxr-xr-x guolin staff 
-rwW-r--r-- guolin staff 
-rwWXr--r-- guolin staff 
-rW-r--r-- guolin staff gradlew.bat 
-rwW-r--r-- guolin staff local .properties 
-rw-r--r-- 1 guolin staff 6 :07 settings.gradle 
guolindeMacBook-Pro:BroadcastBestPractice guolin$ 


.git 

.gitignore 
.gradle 

.idea 
BroadcastBestPractice,.,iml 
app 

build 
build.gradle 
gradle 
gradle.properties 
gradlew 


OONONONNNNONmONNION 


:1 
5 
1 
1 
9 
3 
1 
3 
1 
1 
4 
1 


图 6.23 ”查看 .git 目 录 
如 果 你 想 要 删除 本 地 仓库 ， 只 需要 删除 这 个 目录 就 行 了 。 
6.6.3 ”提交 本 地 代码 


建立 完 代码 仓库 之 后 就 可 以 提交 代码 了 。 提 交代 码 的 方法 非常 简单 ， 只 需要 使 用 add 和 commit 
命令 就 可 以 了 。add 用 于 把 想 要 提交 的 代码 添加 进来 ，commit 则 是 真正 执行 提交 操作 。 比 如 我 
们 想 添 加 build.gradle 文 件 , 就 可 以 输入 如 下 命令 : 


git add build.gradle 


这 是 添加 单个 文件 的 方法 ， 如 果 我 们 想 添加 某 个 目录 呢 ? 其 实 只 需要 在 add 后 面 加 上 目录 名 就 可 
以 了 。 比 如 要 添加 整个 app 目 录 下 的 所 有 文件 ， 就 可 以 输入 如 下 命令 : 


git add app 


可 是 这 样 一 个 个 地 添加 还 是 有 些 复杂 ， 有 没有 什么 办 法 可 以 一 次 性 把 所 有 的 文件 都 添加 好 呢 ? 
当然 有 了 ， 只 需要 在 add 后 面 加 上 一 个 点 ， 就 表示 添加 所 有 的 文件 了 ， 命 令 如 下 所 示 : 


git add . 


现在 BroadcastBestPractice 项 目下 所 有 的 文件 都 已 经 添加 好 了 ， 我们 可 以 进行 提交 了 ， 输 入 
如 下 命令 即 可 : 


git commit -m "First commit." 


注意 ，, 在 commit 命 令 的 后 面 ， 我 们 一 定 要 通过 -m 参 数 加 上 提交 的 描述 信息 ,没有 描述 信息 的 提 
交 被 认为 是 不 合法 的 。 这 样 所 有 的 代码 就 成 功 提交 了 ! 
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好 了 ， 关 于 Git 的 内 容 ， 今 天 我 们 就 学 到 这 里 。 虽 然 内 容 并 不 多 ， 但 是 你 已 经 将 Git 最 基本 的 用 法 
都 掌握 了 ， 不 是 吗 ? 在 本 书后 面 的 章节 还 会 穿插 一 些 Git 的 讲解 ， 到 时 候 你 将 学 会 更 多 关于 Git 的 
使 用 技巧 ， 现 在 就 让 我 们 来 总 结 一 下 吧 。 
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6.7 ”小结 与 皮 评 


本 章 我 们 主要 是 对 Android 的 广播 机 制 进 行 了 深入 的 研究 ， 不 仅 了 解 了 广播 的 理论 知识 ， 还 掌握 
了 接收 广播 、 发 送 自 定义 广播 以 及 本 地 广播 的 使 用 方法 。BroadcastReceiver 属 于 Android 四 
大 组 件 之 一 ， 在 不 知 不 觉 中 ， 你 已 经 掌握 了 四 大 组 件 中 的 两 个 了 。 


在 最 佳 实践 环节 中 ， 你 一 定 也 收获 了 不 少 ， 不 仅 运 用 到 了 本 章 所 学 的 广播 知识 ， 还 综合 运用 到 
了 前 面 章节 所 学 到 的 技巧 。 通 过 这 个 例子 ， 相 信 你 对 涉及 的 每 个 知识 点 都 有 了 更 深 的 认识 。 本 
章 的 Kotlin 课 堂 也 是 干货 满 满 , 高 阶 孙 数 这 个 知识 点 非常 重要 ， 你 一 定 要 好 好 掌握 。 


另外 ， 本章 还 添加 了 一 个 特殊 的 环节 ， 即 Git 时 间 。 在 这 个 环节 中 ， 我 们 对 Git 这 个 版 本 控制 工具 
进行 了 初步 的 学 习 ， 后 续 章节 里 还 会 继续 学 习 关 于 它 的 更 多 内 容 。 


下 一 章 我 们 本 应 该 学 习 Android 四 大 组 件 中 的 ContentProvider , 不 过 由 于 学 习 
ContentProvider 之 前 需要 先 掌握 Android 中 的 持久 化 技术 ， 因 此 下 一 章 我 们 就 先 对 这 一 主题 
展开 讨论 。 
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第 7 章 数据 存储 全 方案 ,详解 持久 化 技术 


任何 一 个 应 用 程序 ,其实 说白 了 就 是 在 不 停 地 和 数据 打交道 ， 我 们 聊 QQ、 看 新 闻 、 刷 微 博 , 所 
关心 的 都 是 里 面 的 数据 ,没有 数据 的 应 用 程序 就 变 成 了 一 个 空 壳 子 ， 对 用 户 来 说 没有 任何 实际 
用 途 。 那 么 这 些 数 据 是 从 哪儿 来 的 呢 ? 现在 多 数 的 数据 基本 是 由 用 户 产 生 的 ， 比 如 你 发 微 博 、 
评论 新 闻 ， 其实 都 是 在 产生 数据 。 


我 们 前 面 章节 所 编写 的 众多 例子 中 也 使 用 到 了 一 些 数据 ,例如 第 4 章 最 佳 实践 部 分 在 聊天 界面 编 
写 的 聊天 内 容 ， 第 6 章 最 佳 实践 部 分 在 登录 界面 输入 的 账号 和 密码 。 这 些 数据 有 一 个 共同 点 ， 即 
它们 都 属于 瞬时 数据 。 那 么 什么 是 瞬时 数据 呢 ? 就 是 指 那些 存储 在 内 存 当中 ， 有 可 能 会 因为 程 
序 关闭 或 其 他 原因 导致 内 存 被 回收 而 丢失 的 数据 。 这 对 于 一 些 关 键 性 的 数据 信息 来 说 是 绝对 不 
能 容忍 的 ， 谁 都 不 希望 自己 刚 发 出 去 的 一 条 微 博 ， 刷新 一 下 就 没 了 7 吧 。 那 么 怎样 才能 保证 一 些 
关键 性 的 数据 不 会 丢失 呢 ? 这 就 需要 用 到 数据 持久 化 技术 了 。 
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7.1 持久 化 技术 简介 


数据 持久 化 就 是 指 将 那些 内 存 中 的 瞬时 数据 保存 到 存储 设备 中 ， 保 证 即使 在 于 机 或 计算 机 关机 
的 情况 下 ， 这 些 数据 仍然 不 会 丢失 。 保 存在 内 存 中 的 数据 是 处 于 瞬时 状态 的 ， 而 保存 在 存储 设 
备 中 的 数据 是 处 于 持久 状态 的 。 持 久 化 技术 提供 了 一 种 机 制 ， 可 以 让 数据 在 瞬时 状态 和 持久 状 
态 之 间 进 行 转换 。 


持久 化 技术 被 广泛 应 用 于 各 种 程序 设计 领域 ， 而 本 节 要 探讨 的 自然 是 Android 中 的 数据 持久 化 技 
术 。Android 系 统 中 主要 提供 了 3 种 方式 用 于 简单 地 实现 数据 持久 化 功能 : 文件 存储 、 
SharedPreferences 存 储 以 及 数据 库存 储 。 


下 面 我 就 将 对 这 3 种 数据 持久 化 的 方式 一 一 进行 详细 的 讲解 。 
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7.2 文件 存储 


文件 存储 是 Android 中 最 基本 的 数据 存储 方式 ， 它 不 对 存储 的 内 容 进 行 任何 格式 化 处 理 ， 所 有 数 
据 都 是 原封 不 动 地 保存 到 文件 当中 的 ， 因 而 它 比 较 适 合 存储 一 些 简 单 的 文本 数据 或 二 进 制 数 

据 。 如 果 你 想 使 用 文件 存储 的 方式 来 保存 一 些 较为 复杂 的 结构 化 数据 ， 就 需要 定义 一 套 自己 的 
格式 规范 ， 方 便 之 后 将 数据 从 文件 中 重新 解析 出 来 。 


那么 首先 我 们 就 来 看 一 看 ,Android 中 是 如 何 通过 文件 来 保存 数据 的 。 
7.2.1 将 数据 存储 到 文件 中 


Context 类 中 提供 了 一 个 openFiLe0utput () 方 法 ， 可 以 用 于 将 数据 存储 到 指定 的 文件 中 。 这 
个 方法 接收 两 个 参数 : 第 一 个 参数 是 文件 名 ， 在 文件 创建 的 时 候 使 用 ， 注 意 这 里 指定 的 文件 名 
不 可 以 包含 路 径 ， 因 为 所 有 的 文件 都 默认 存储 到 /data/data/<package name>/files/ 目 录 

下 ; 第 二 个 参数 是 文件 的 操作 模式 ， 主 要 有 MODE_PRIVATE 和 MODE_APPEND 两 种 模式 可 选 ， 默 
认 是 MODE_PRIVATE ， 表 示 当 指定 相同 文件 名 的 时 候 ， 所 写 入 的 内 容 将 会 覆盖 原文 件 中 的 内 

容 , 而 MODE_APPEND 则 表示 如 果 该 文件 已 存在 ， 就 往 文件 里 面 追加 内 容 ， 不 存在 就 创建 新 文 
件 。 其 实 文件 的 操作 模式 本 来 还 有 另外 两 种 : MODE WORLD_READABLE 和 

MODE_WORLD_ WRITEABLE。 这 两 种 模式 表示 人 允许 其 他 应 用 程序 对 我 们 程序 中 的 文件 进行 读 写 
操作 ， 不 过 由 于 这 两 种 模式 过 于 危险 ,很 容易 引起 应 用 的 安全 漏洞 ， 已 在 Android 4.2 版 本 中 被 


废弃 。 


openFitLe0utput () 方 法 返回 的 是 一 个 FiLe0utputSt ream 对 象 ， 得 到 这 个 对 象 之 后 就 可 以 
使 用 ava 流 的 方式 将 数据 写 入 文件 中 了 。 以 下 是 一 段 简单 的 代码 示例 ， 展 示 了 如 何 将 一 段 文本 
内 容 保存 到 文件 中 : 


fun save(inputText: String) { 
try { 
val output = openFileOQutput("data", Context.MODE PRIVATE) 
val writer = BufferedWriter(OutputStreamWriter(output)) 
writer.use { 
it.write(inputText) 


} 
} catch (e: IOException) { 
e.printStackTrace() 


| 


如 果 你 已 经 比较 熟悉 Java 流 了 ,上面 的 代码 一 定 不 难 理解 吧 。 这 里 通过 openFile0utput() 方 
法 能 够 得 到 一 个 FiLe0utputSt ream 对 象 ， 然 后 借助 它 构建 出 一 个 OutputStreamWriter 对 
象 ， 接 着 再 使 用 0utputStreamWriter 构 建 出 一 个 BufferedWriter 对 象 ， 这样 你 就 可 以 通 

过 BufferedWwriter 将 文本 内 容 写 入 文件 中 了 。 


注意 ， 这 里 还 使 用 了 一 个 use 了 数 ， 这 是 Kotlin 提 供 的 一 个 内 置 扩展 水 数 。 它 会 保证 在 Lambda 
表达 式 中 的 代码 全 部 执行 完 之 后 自动 将 外 层 的 流 关闭 ， 这 样 就 不 需要 我 们 再 编写 一 个 finally 
语句 ,手动 去 关闭 流 了 ,是 一 个 非常 好 用 的 扩展 函数 。 
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另外 ，Kotlin 是 没有 异常 检查 机 制 (checked exception) 的 。 这 意味 着 使 用 Kotlin 编 写 的 所 
有 代码 都 不 会 强制 要 求 你 进行 异常 捕获 或 异常 抛 出 。 上 述 代 码 中 的 try catch 代 码 块 是 参照 
java 的 编程 规范 添加 的 ， 即 使 你 不 写 try catch 代 码 块 ， 在 Kotlin 中 依然 可 以 编译 通过 。 


至 于 为 什么 Kotlin 中 没有 异常 检查 机 制 ， 我 写 了 一 篇 非常 详细 的 文章 来 分 析 这 个 问题 。 如 果 你 有 
兴趣 学 习 ， 可 以 关注 我 的 微 信 公 众 号 ( 见 封面 ) ， 回 复 “ 异 党 检查 “ 即 可 。 


下 面 我 们 就 编写 一 个 完整 的 例子 ， 借 此 学 习 一 下 如 何在 Android 项 目 中 使 用 文件 存储 的 技术 。 首 
先 创建 一 个 FilePersistenceTest 项 目 ， 并 修改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<EditText 
android:id="@+id/editText" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="Type something here" 
/> 


</LinearLayout> 


这 里 只 是 在 布局 中 加 入 了 一 个 EditText , 用 于 输入 文本 内 容 。 


其 实现 在 你 就 可 以 运行 一 下 程序 了 ， 界面 上 肯定 会 有 一 个 文本 输入 框 。 然 后 在 文本 输入 框 中 随 
意 输入 点 什么 内 容 ， 再 按 下 Back 键 ， 这 时 输入 的 内 容 肯定 就 已 经 丢失 了 ,因为 它 只 是 瞬时 数 
据 , 在 Activity 被 销毁 后 就 会 被 回收 。 而 这 里 我 们 要 做 的 ， 就 是 在 数据 被 回收 之 前 ， 将 它 存储 到 
文件 当中 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


} 


override fun onDestroy() { 
super.onDestroy() 
val inputText = editText.text.toString() 
save(inputText) 


} 
private fun save(inputText: String) { 
try { 
val output openFileOutput("data", Context.MODE PRIVATE) 


val writer = 
writer.use { 
it.write(inputText) 


BufferedWriter(OutputStreamWriter(output)) 


} 

} catch (e: IOException) { 
e.printStackTrace() 

} 
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可 以 看 到 ， 首 先 我 们 重 写 了 onDestroy ( ) 方 法 , 这 样 就 可 以 保证 在 Activity 销 毁 之 前 一 定 会 调 
用 这 个 方法 。 在 onDestroy ( ) 方 法 中 ,我们 获取 了 EditText 中 输入 的 内 容 ， 并 调用 save( ) 方 
法 把 输入 的 内 容 存储 到 文件 中 ,文件 命 名 为 data。save() 方 法 中 的 代码 和 之 前 的 示例 基本 相 
同 ， 这 里 就 不 再 做 解释 了 。 现 在 重新 运行 一 下 程序 ， 并 在 EditText 中 输入 一 些 内 容 ， 如 图 7.1 所 
示 。 


8:56 Sa | 


FilePersistenceTest 


Something importand| 


图 7.1 在 EditText 中 随意 输入 点 内 容 


然后 按 下 Back 刍 关闭 程序 ， 这 时 我 们 输入 的 内 容 就 保存 到 文件 中 了 。 那 么 如 何 才能 证 实数 据 确 
实 已 经 保存 成 功 了 呢 ?我 们 可 以 借助 Device File Explorer 工 具 查 看 一 下 。 这 个 工具 在 Android 
Studio 的 右 侧 边栏 当中 ， 通 常 是 在 右 下 角 的 位 置 ,如 果 你 的 右 侧 边 栏 中 没有 这 个 工具 的 话 ， 也 

可 以 使 用 快捷 键 Ctrl + Shift + A (Mac 系统 是 command + shift + A) 打开 搜索 功能 ， 在 搜 
索 框 中 输入 “Device File Explorer" 即 可 找到 这 个 工具 。 
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这 个 工具 其 实 就 相当 于 一 个 设备 文件 浏览 希 ， 我 们 在 这 里 找 
至 J/data/data/com.example.filepersistencetest/files/ 目 录 ,可 以 看 到 ， 现在 已 经 生成 了 一 
个 data 文 件 , 如 图 7.2 所 示 。 


Device File Explorer 他 一 
甬 Emulator Pixel_API_29 Android 10, API 29 ~ 

Name Permissions Date Size 
com.example.activitylifecycletest drwxrwx--X 2019-06-12 07:47 4KB 
com.example.activitytest drwxrwx--X 2019-06-12 07:47 4KB 
com.example.broadcastbestpractice drwxrwx--X 2019-06-12 07:47 4KB 
com.example.broadcasttest drwxrwx--X 2019-06-12 07:47 4KB 
com.example.filepersistencetest drwxrwx--X 2019-06-12 07:47 4KB 
cache drwxrws--X 2019-07-06 20:41 4KB 
code_cache drwxrws--X 2019-07-06 20:41 4KB 
files drwxrwx--X 2019-07-06 20:57 4KB 

2019-07-06 20:57 

com.example.fragmentbestpractice drwxrwx--X 2019-06-12 07:47 4KB 
com.example.fragmenttest drwxrwx--X 2019-06-12 07:47 4KB 
com.example.uiwidgettest drwxrwx--X 2019-06-12 07:47 4KB 


图 7.2 ”生成 的 data 文 件 
双击 这 个 文件 就 可 以 查看 里 面 的 内 容 ， 如 图 7.3 所 示 。 


三 data 


Something important 


图 7.3 ” data 文件 中 的 内 容 
这 样 就 证 实 了 在 EditText 中 输入 的 内 容 确实 已 经 成 功 保存 到 文件 中 了 。 


不 过 ， 只 是 成 功 将 数据 保存 下 来 还 不 够 ， 我 们 还 需要 想 办 法 在 下 次 启动 程序 的 时 候 让 这 些 数据 
能 够 还 原 到 EditText 中 ， 因 此 接 下 来 我 们 就 要 学 习 一 下 如 何 从 文件 中 读 取 数 据 。 


7.2.2 ”从 文件 中 读 取 数 据 


类 似 于 将 数据 存储 到 文件 中 ，Context 类 中 还 提供 了 一 个 openFileInput() 方 法 ,用 于 从 文 

件 中 读 取 数据 。 这 个 方法 要 比 openFile0utput() 简 单一 些 , 它 只 接收 一 个 参数 ， 即 要 读 取 的 
文件 名 ， 然 后 系统 会 自动 到 /data/data/<package name>/files/ 目 录 下 加 载 这 个 文件 ,并 返 
回 一 个 FileInputStream 对 象 ， 得 到 这 个 对 象 之 后 ， 再 通过 流 的 方式 就 可 以 将 数据 读 取出 来 

了 。 


以 下 是 一 段 简单 的 代码 示例 ， 展 示 了 如 何 从 文件 中 读 取 文 本 数据 : 


fun load(): String { 
val content = StringBuilder() 
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try { 
val input = openFileInput("data") 
val reader = BufferedReader(InputStreamReader(input)) 
reader.use { 
reader.forEachLine { 
content.append (it) 
} 


} 

} catch (e: IOException) { 
e.printStackTrace() 

} 


return content.toString() 


} 


在 这 段 代码 中 ， 首 先 通过 openFileInput() 方 法 获取 了 一 个 FileInputStream 对 象 ， 然 后 
借助 它 又 构建 出 了 一 个 InputStreamReader 对 象 ， 接 着 再 使 用 InputStreamReader 构 建 出 
一 个 BufferedReader 对 象 , 这 样 我 们 就 可 以 通过 BufferedReader 将 文件 中 的 数据 一 行 行 读 
取出 来 ， 并 拼接 到 St ringBuitLder 对 象 当中 ， 最 后 将 读 取 的 内 容 返回 就 可 以 了 。 


注意 ,这 里 从 文件 中 读 取 数 据 使 用 了 一 个 forEachLine 函 数 , 这 也 是 Kotlin 提 供 的 一 个 内 置 扩 
展 函 数 ， 它 会 将 读 到 的 每 行内 容 都 回调 到 Lambda 表 达 式 中 ， 我 们 在 Lambda 表 达 式 中 完成 拼 
接 逻 辑 即 可 。 


了 解 了 从 文件 中 读 取 数据 的 方法 ， 那么 我 们 就 来 继续 完善 上 一 小 节 中 的 例子 ， 使 得 重新 启动 程 
序 时 EditText 中 能 够 保留 我 们 上 次 输入 的 内 容 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val inputText = Load () 
if (inputText.isNotEmpty()) { 
editText.setText (inputText) 
editText.setSelection(inputText. Length) 
Toast.makeText(this, "Restoring succeeded", Toast.LENGTH SHORT).show() 


} 


private fun load(): String { 
val content = StringBuilder() 
try { 
val input = openFileInput("data") 
val reader = BufferedReader(InputStreamReader(input)) 
reader.use { 
reader.forEachLine { 
content.append(it) 
} 


} 
} catch (e: IOException) { 
e.printStackTrace() 


return content.toString() 
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可 以 看 到 ,这 里 的 思路 非常 简单 ， 在 onCreate ( ) 方 法 中 调用 Load ( ) 方 法 读 取 文 件 中 存储 的 文 
本 内 容 ， 如 果 读 到 的 内 容 不 为 空 ， 就 调用 EditText 的 SetText ( ) 方 法 将 内 容 填充 到 EditText 
里 ， 并 调用 setSetLection( ) 方 法 将 输入 光标 移动 到 文本 的 末尾 位 置 以 便 继 续 输 入 ， 然 后 弹出 
一 句 还 原 成 功 的 提示 。Load ( ) 方 法 中 的 细节 我 们 在 前 面 已 经 讲 过 ， 这 里 就 不 再 袭 述 了 。 


现在 重新 运行 一 下 程序 ， 刚才 保存 的 Something important 字 符 串 肯定 会 被 填充 到 EditText 
中 ,然后 编写 一 点 其 他 的 内 容 ， 比 如 在 EditText 中 输入 “Hello world”，, 接着 按 下 Back 键 退出 
程序 ， 再 重新 启动 程序 ， 这 时 刚才 输入 的 内 容 并 不 会 丢失 ,而 是 还 原 人 了 EditText 中 ， 如 图 7.4 
所 示 。 


2:08 


FilePersistenceTest 


Hello world 


Restoring succeeded 


图 7.4 成功 还 原 保存 的 内 容 


这 样 我 们 就 已 经 把 文件 存储 方面 的 知识 学 习 完了 ， 其 实 所 用 到 的 核心 技术 就 是 Context 类 中 提 
供 的 openFileInput() 和 openFile0utput() 方 法 ,之 后 就 是 利用 各 种 流 来 进行 读 写 操作 。 
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不 过 ， 正 如 我 前 面 所 说 ,文件 存储 的 方式 并 不 适合 用 于 保存 一 些 较为 复杂 的 结构 型 数据 ， 
此 ,下面 我 们 就 来 学 习 一 下 Android 中 另 一 种 数据 持久 化 的 方式 ， 它 比 文件 存 储 更 加 简单 易 用 ， 
而 且 可 以 很 方便 地 对 某 些 指定 的 数据 进行 读 写 操作 。 
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7.3 SharedPreferences 存 储 


不 同 于 文件 的 存储 方式 , SharedPreferences 是 使 用 键 值 对 的 方式 来 存储 数据 的 。 也 就 是 说 ， 
当 保 存 一 条 数据 的 时 候 ， 需 要 给 这 条 数据 提供 一 个 对 应 的 键 ， 这 样 在 读 取 数 据 的 时 候 就 可 以 通 
过 这 个 键 把 相应 的 值 取出 来 。 而 且 SharedPreferences 还 支持 多 种 不 同 的 数据 类 型 存储 ， 如果 
存储 的 数据 类 型 是 整 型 ， 那 么 读 取出 来 的 数据 也 是 整 型 的 ; 如 果 存 储 的 数据 是 一 个 字符 串 ， 那 
么 读 取出 来 的 数据 仍然 是 字符 串 。 


这 样 你 应 该 就 能 明显 地 感觉 到 ,使 用 SharedPreferences 进 行 数据 持久 化 要 比 使 用 文件 方便 很 
多 ,下 面 我们 就 来 看 一 下 它 的 具体 用 法 吧 。 
7.3.1 将 数据 存储 到 SharedPreferences 中 


要 想 使 用 SharedPreferences 存 储 数 据 ,首先 需要 获取 SharedPreferences 对 象 。Android 
中 主要 提供 了 以 下 两 种 方法 用 于 得 到 SharedPreferences 对 象 。 


01. Context 类 中 的 getSharedPreferences () 方 法 


此 方法 接收 两 个 参数 : 第 一 个 参数 用 于 指定 SharedPreferences 文 件 的 名 称 ， 如 果 指 定 的 
文件 不 存在 则 会 创建 一 个 , SharedPreferences 文 件 都 是 存放 在 /data/data/<package 
name>/shared_prefs/ 目 录 下 的 ; 第 二 个 参数 用 于 指定 操作 模式 ， 目 前 只 有 默认 的 
MODE_PRIVATE 这 一 种 模式 可 选 ， 它 和 直接 传 入 0 的 效果 是 相同 的 ， 表 示 只 有 当前 的 应 用 程 
序 才 可 以 对 这 个 SharedPreferences 文 件 进行 读 写 。 其 他 几 种 操作 模式 均 已 被 废弃 ， 
MODE WORLD READABLE 和 MODE WORLD WRITEABLE 这 两 种 模式 是 在 Android 4.2 版 本 
中 被 废弃 的 ，MODE MULTI _PROCESS 模 式 是 在 Android 6.0 版 本 中 被 废弃 的 。 


02. Activity 类 中 的 getPreferences() 方 法 
这 个 方法 和 Context 中 的 getSharedPreferences ( ) 方 法 很 相似 ， 不 过 它 只 接收 一 个 操 
作 模 式 参 数 ， 因 为 使 用 这 个 方法 时 会 自动 将 当前 Activity 的 类 名 作为 
SharedPreferences 的 文件 名 。 


得 到 了 SharedPreferences 对 象 之 后 ,就 可 以 开始 向 SharedPreferences 文 件 中 存储 数 
据 了 ， 主 要 可 以 分 为 3 步 实 现 。 


(1) 调用 SharedPreferences 对 象 的 edit( ) 方 法 获取 一 个 
SharedPreferences .Editor 对 象 。 


(2) 向 SharedPreferences ,Editor 对象 中 添加 数据 ， 比如 添加 一 个 布尔 型 数据 就 使 用 
putBoolean() 方 法 ,添加 一 个 字符 串 则 使 用 putString() 方 法 ,以 此 类 推 。 


(3) 调用 apply ( ) 方 法 将 添加 的 数据 提交 ， 从 而 完成 数据 存储 操作 。 


不 知 不 觉 中 已 经 将 理论 知识 介绍 得 挺 多 了 “， 那 我 们 就 赶快 通过 一 个 例子 来 体验 一 下 
SharedPreferences 存 储 的 用 法 吧 。 新 建 一 个 SharedPreferencesTest 项 目 ， 然 后 修改 
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activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/saveButton" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Save Data" 
/> 


</LinearLayout> 


这 里 我 们 不 做 任何 复杂 的 功能 ， 只 是 简单 地 放置 了 一 个 按钮 ， 用 于 将 一 些 数据 存储 到 
SharedPreferences 文 件 当 中 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
saveButton.setOnClickListener { 
val editor = getSharedPreferences("data", Context.MODE PRIVATE).edit() 
editor.putString("name", "Tom") 
editor.putInt("age", 28) 
editor.putBoolean("married", false) 
editor.apply() 


} 


可 以 看 到 ， 这 里 首先 给 按钮 注册 了 一 个 点 击 事件 ， 然 后 在 点 击 事件 中 通过 
getSharedPreferences () 方 法 指定 SharedPreferences 的 文件 名 为 data ， 并 得 到 了 
SharedPreferences .Editor 对 象 。 接 着 向 这 个 对 象 中 添加 了 3 条 不 同类 型 的 数据 ,最 
后 调用 apptLy ( ) 方 法 进行 提交 ， 从 而 完成 了 数据 存储 的 操作 。 


很 简单 吧 ? 现在 就 可 以 运行 一 下 程序 了 。 进 入 程序 的 主 界 面 后 , 点击 一 下 “Save Data” 按 
钮 。 这 时 的 数据 应 该 已 经 保存 成 功 了 ， 不 过 为 了 证 实 一 下 ， 我们 还 是 要 借助 Device File 
Explorer 来 进行 查看 。 打 开 Device File Explorer ,然后 进 

入 /data/data/com.example.sharedpreferencestest/shared_prefs/ 目 录 下 ， 可 以 看 
到 | 生成 了 一 个 data.xmI 文 件 ， 如 图 7.5 所 示 。 
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Device File Explorer 你 一 


盟 Emulator Pixel_APL29 Android 10, API 29 了 
Name Permissions Date Size 

com.example.broadcasttest drwxrwx--x 2019-06-12 07:47 4 KB 

com.example.filepersistencetest drwxrwx--x 2019-06-12 07:47 4 KB 

com.example.fragmentbestpracti drwxrwx--x 2019-06-12 07:47 4 KB 

com.example.fragmenttest drwxrwx--x 2019-06-12 07:47 4 KB 

com.example.sharedpreferencest drwxrwx--x 2019-06-12 07:47 4 KB 

cache drwxrws--x 2019-07-07 18:56 4 KB 

code_cache drwxrws--x 2019-07-07 18:56 4 KB 

shared_prefs drwxrwx--x 2019-07-07 18:57 4 KB 


data.xml 2019-07-07 18:57 


com.example.uiwidgettest drwxrwx--x 2019-06-12 07:47 4 KB 
图 7.5 生成 的 data.xml 文 件 
接 下 来 同样 是 双击 打开 这 个 文件 ,里 面 的 内 容 如 图 7.6 所 示 。 


tn data.xml | 


1 <?xmL version='1.0' encoding='utf-8' standalone='yes' ?> 
<map> 
<string name="name">Tom</string> 
<boolean name="married" value="false" /> 
<int name="age" value="28" /> 
</map> 


图 7.6 data.xml 文 件 中 的 内 容 


可 以 看 到 ， 我 们 刚刚 在 按钮 的 点 击 事件 中 添加 的 所 有 数据 都 已 经 成 功 保存 下 来 了 ， 并 且 
SharedPreferences 文 件 是 使 用 XML 格式 来 对 数据 进行 管理 的 。 


那么 接 下 来 我 们 自然 要 看 一 看 ， 如何 从 SharedPreferences 文 件 中 去 读 取 这 些 存储 的 数据 
了 。 


7.3.2 从 SharedPreferences 中 读 取 数据 


你 应 该 已 经 感觉 到 了 ， 使 用 SharedPreferences 存 储 数据 是 非常 简单 的 ， 不 过 下 面 还 有 更 好 的 
消息 , 因为 从 SharedPreferences 文 件 中 读 取 数据 会 更 加 简单 。SharedPreferences 对 象 中 
提供 了 一 系列 的 get 方 法 ， 用 于 读 取 存 储 的 数据 ， 每 种 get 方 法 都 对 应 了 
SharedPreferences.Editor 中 的 一 种 put 方 法 ,比如 读 取 一 个 布尔 型 数据 就 使 用 
getBoolean() 方 法 , 读 取 一 个 字符 串 就 使 用 getString() 方 法 。 这 些 get 方 法 都 接收 两 个 参 
数 : 第 一 个 参数 是 键 ， 传 入 存储 数据 时 使 用 的 键 就 可 以 得 到 相应 的 值 了 ; 第 二 个 参数 是 默认 
值 , 即 表示 当 传 入 的 键 找 不 到 对 应 的 值 时 会 以 什么 样 的 默认 值 进 行 返回 。 


我 们 还 是 通过 例子 来 实际 体验 一 下 吧 ,仍然 是 在 SharedPreferencesTest 项 目的 基础 上 继续 开 
发 ,修改 activity_main.xml 中 的 代码 ,如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/saveButton" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Save Data" 
/> 


<Button 
android:id="@+id/restoreButton" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Restore Data" 
/> 


</LinearLayout> 


这 里 增加 了 一 个 还 原 数 据 的 按钮 ， 我们 希望 通过 点 击 这 个 按钮 来 从 SharedPreferences 文 件 中 
读 取 数据 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


restoreButton.setOnClickListener { 
val prefs = getSharedPreferences("data", Context.MODE PRIVATE) 
val name = prefs.getString("name", "") 
val age = prefs.getIint("age", 0) 
val married = prefs.getBoolean("married", false) 


Log.d("MainActivity", "name is $name") 
Log.d("MainActivity", "age is $age") 
Log.d("MainActivity", "married is $married") 


} 


可 以 看 到 ， 我 们 在 还 原 数据 按钮 的 点 击 事件 中 首先 通过 getSharedPreferences ( ) 方 法 得 到 
了 SharedPreferences 对 象 ， 然 后 分 别 调用 它 的 getString()、getInt () 和 
getBooLean ( ) 方 法 ， 去 获取 前 面 所 存储 的 姓名 、 年 龄 和 是 否 已 婚 ， 如果 没有 找到 相应 的 值 ， 
就 会 使 用 方法 中 传 入 的 默认 值 来 代替 ， 最 后 通过 Log 将 这 些 值 打印 出 来 。 


现在 重新 运行 一 下 程序 , 并 点 击 界面 上 的 “Restore data" 按 钮 ， 然 后 查看 Logcat 中 的 打印 信 
息 ， 如 图 7.7 所 示 。 


com.example.sharedpreferencest Verbose “ 避 


231/com.example.sharedpreferencestest D/MainActivity: name is Tom 
231/com.example,.sharedpreferencestest D/MainActivity: age is 28 
231/com.example.sharedpreferencestest D/MainActivity: married is false 


图 7.7 ”打印 data.xml 中 存储 的 内 容 
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所 有 之 前 存储 的 数据 都 成 功 读 取出 来 了 ! 通过 这 个 例子 ， 我 们 就 把 SharedPreferences 存 储 的 
知识 学 习 完 了 。 相 比 之 下 ，SharedPreferences 存 储 确实 要 比 文本 存储 简单 方便 了 许多 ， 应 用 
场景 也 多 了 不 少 ， 比 如 很 多 应 用 程序 中 的 偏好 设置 功能 其 实 就 使 用 到 了 SharedPreferences 技 
术 。 那 么 下 面 我 们 就 来 编写 一 个 记 住 密码 的 功能 ， 相 信和 通过 这 个 例子 能 够 加 深 你 对 
SharedPreferences 的 理解 。 


7.3.3 ”实现 记 住 密码 功能 


既然 是 实现 记 住 密码 的 功能 ， 那 么 我 们 就 不 需要 从 头 去 写 了 ， 因 为 在 上 一 章 中 的 最 佳 实践 部 分 
已 经 编写 过 一 个 登录 界面 了 ， 有 可 以 重用 的 代码 为 什么 不 用 呢 ? 那 就 首先 打开 
BroadcastBestPractice 项 目 ， 编 辑 一 下 登录 界面 的 布局 。 修 改 activity_login.xml 中 的 代 
码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<LinearLayout 
android:orientation="horizontal" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<CheckBox 
android:id="@+id/rememberPass" 
android:layout width="wrap_ content" 
android:layout height="wrap content" /> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:textSize="18sp" 
android:text="Remember password" /> 


</LinearLayout> 


<Button 
android:id="@+id/login" 
android:layout width="match parent" 
android:layout height="60dp" 
android:text="Login" /> 


</LinearLayout> 


这 里 使 用 了 一 个 新 控件 : CheckBox。 这 是 一 个 复 选 框 控件 ， 用 户 可 以 通过 点 击 的 方式 进行 选中 
和 取消 ， 我 们 就 使 用 这 个 控件 来 表示 用 户 是 否 需要 记 住 密码 。 


然后 修改 LoginActivity 中 的 代码 ， 如 下 所 示 : 


class LoginActivity : BaseActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity login) 
val prefs = getPreferences(Context.MODE PRIVATE) 
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val isRemember = prefs.getBoolean("remember password", false) 
if (isRemember) { 

// 将 账号 和 密码 都 设置 到 文本 框 中 

val account = prefs.getString("account", "") 

val password = prefs.getString("password", "") 

accountEdit.setText (account) 

passwordEdit.setText (password) 

rememberPass.isChecked = true 


} 
login.setOnClickListener { 
val account = accountEdit.text.toString() 
val password = passwordEdit. text.toString() 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account == "admin" && password == "123456") { 
val editor = prefs.edit() 
if (rememberPass.isChecked) { // 检查 复 选 框 是 否 被 选中 
editor.putBoolean("remember password", true) 
editor.putString("account", account) 
editor.putString("password", password) 
} else { 
editor.clear() 


} 
editor.apply() 
val intent = Intent(this, MainActivity::class.java) 
startActivity(intent) 
finish() 
} else { 
Toast.makeText(this, "account or password is invalid", 
Toast .LENGTH SHORT).show() 


} 


可 以 看 到 ， 这 里 首先 在 onCreate ( ) 方 法 中 获取 了 SharedPreferences 对 象 ， 然 后 调用 它 的 
getBooLean ( ) 方 法 去 获取 remember _password 这 个 键 对 应 的 值 。 一 开始 当然 不 存在 对 应 的 
值 了 ， 所 以 会 使 用 默认 值 faLse , 这 样 就 什么 都 不 会 发 生 。 接 着 在 登录 成 功 之 后 ， 会 调用 
CheckBox 的 isChecked ( ) 方 法 来 检查 复 选 框 是 人 否 被 选中 。 如 果 被 选中 了 ， 则 表示 用 户 想 要 记 
住 密码 ， 这 时 将 remember_password 设 置 为 true， 然后 把 account 和 password 对 应 的 值 都 
存 入 SharedPreferences 文 件 中 并 提交 ; 如 果 没 有 被 选中 ， 就 简单 地 调用 一 下 cLear ( ) 方 法 ， 
将 SharedPreferences 文 件 中 的 数据 全 部 清除 掉 。 


当 用 户 选 中 了 记 住 密码 复 选 框 ， 并 成 功 登 录 一 次 之 后 ,remember_password 键 对 应 的 值 就 是 
true 了 ， 这 个 时 候 如 果 重 新 启动 登录 界面 ， 就 会 从 SharedPreferences 文 件 中 将 保存 的 账号 和 
密码 都 读 取 出 来 ， 并 填充 到 文本 输入 框 中 ， 然 后 把 记 住 密码 复 选 框 选中 ， 这 样 就 完成 记 住 密码 
的 功能 


现在 重新 运行 一 下 程序 ,可 以 看 到 界面 上 多 了 一 个 记 住 密码 复 选 框 ， 如 图 7.8 所 示 。 
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10:13 > | 


BroadcastBestPractice 


Account 


Password 


口 Remember password 


LOGIN 


图 7.8 ” 带 有 记 住 密码 复 选 框 的 登录 界面 


然后 账号 输入 admin ,密码 输入 123456 ,并 选中 记 住 密码 复 选 框 ， 点 击 登录 ， 就 会 跳 转 到 
MainActivity。 接 着 在 MainActivity 中 发 出 一 条 强制 下 线 广播 ， 会 让 程序 重新 回 到 登录 界面 ， 
此 时 你 会 发 现 ， 账号 和 密码 已 经 自动 填充 到 界面 上 了 ， 如 图 7.9 所 示 。 
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10:13 S| 


BroadcastBestPractice 


Account: admin 
Password: ****** 
Remember password 


LOGIN 


图 7.9 ”实现 记 住 账号 密码 功能 


这 样 我 们 就 使 用 SharedPreferences 技 术 将 记 住 密码 功能 成 功 实现 了 ， 你 是 不 是 对 
SharedPreferences 理 解 得 更 加 深刻 了 呢 ? 


不 过 需要 注意 ， 这 里 实现 的 记 住 密码 功能 仍然 只 是 个 简单 的 示例 ,不 能 在 实际 的 项 目 中 直接 使 
用 。 因 为 将 密码 以 明文 的 形式 存储 在 SharedPreferences 文 件 中 是 非常 不 安全 的 ， 很 容易 被 别 
人 盗 取 ， 因 此 在 正式 的 项 目 里 必须 结合 一 定 的 加 密 算法 对 密码 进行 保护 才 行 。 


好 了 , 关于 SharedpPreferences 的 内 容 就 讲 到 这 里 ， 接 下 来 我 们 要 学 习 一 下 本 章 的 重头 戏 : 
Android 中 的 数据 库 技 术 。 
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7.4 SQLite 数 据 库 存储 


在 刚 开始 接触 Android 的 时 候 ， 我 甚至 都 不 敢 相信 ,Android 系统 竟然 是 内 置 了 数据 库 的 ! 好 
吧 ， 是 我 太 孤 陋 喜 闻 了 。SQLite 是 一 款 轻 量 级 的 关系 型 数据 库 ， 它 的 运算 速度 非常 快 , 占用 资 
源 很 少 ， 通常 只 需要 儿 百 KB 的 内 存 就 足够 了 ， 因 而 特别 适合 在 移动 设备 上 使 用 。SQLite 不 仅 支 
持 标 准 的 SQL 语法 ， 还 遵循 了 数据 库 的 ACID 事务 ， 所 以 只 要 你 以 前 使 用 过 其 他 的 关系 型 数据 

库 ， 就 可 以 很 快 地 上 手 SQLite。 而 SQLite 又 比 一 般 的 数据 库 要 简单 得 多 ， 它 甚至 不 用 设置 用 户 
名 和 密码 就 可 以 使 用 。Android 正 是 把 这 个 功能 极为 强大 的 数据 库 府 入 到 了 系统 当中 ， 使 得 本 地 
持久 化 的 功能 有 了 一 次 质 的 飞跃 。 


前 面 我 们 所 学 的 文件 存储 和 SharedPreferences 存 储 毕 竟 只 适用 于 保存 一 些 简单 的 数据 和 键 
值 对 ， 当 需要 存储 大 量 复 杂 的 关系 型 数据 的 时 候 ， 你 就 会 发 现 以 上 两 种 存储 方式 很 难 应 付 得 
了 。 比 如 我 们 手机 的 短信 程序 中 可 能 会 有 很 多 个 会 话 ， 每 个 会 话 中 又 包含 了 很 多 条 信息 内 容 ， 
并 且 大 部 分 会 话 还 可 能 各 自 对 应 了 通讯 录 中 的 某 个 联系 人 。 很 难 想象 如 何 用 文件 或 者 
SharedPreferences 来 存储 这 些 数 据 量 大 、 结 构 性 复杂 的 数据 吧 ? 但 是 使 用 数据 库 就 可 以 做 
得 到 ,那么 我 们 就 赶快 来 看 一 看 ,Android 中 的 SQLite 数 据 库 到 底 是 如 何 使 用 的 。 


7.4.1 创建 数据 库 


Android 为 了 让 我 们 能 够 更 加 方便 地 管理 数据 库 ， 专门 提供 了 一 个 SQLite0penHelper 帮 助 
类 ， 借助 这 个 类 可 以 非常 简单 地 对 数据 库 进 行 创 建 和 升级 。 既 然 有 好 东西 可 以 直接 使 用 ， 那 我 
们 自然 要 尝试 一 下 了 ， 下 面 我 就 对 SQLite0penHeLper 的 基本 用 法 进行 介绍 。 


首先 ， 你 要 知道 SQLite0penHetLper 是 一 个 抽象 类 ,这 意味 着 如 果 我 们 想 要 使 用 它 ， 就 需要 创 
建 一 个 自己 的 帮助 类 去 继承 它 。SQLite0penHelper 中 有 两 个 抽象 方法 : onCreate ( ) 和 
onUpgrade( ) 。 我 们 必须 在 自己 的 帮助 类 里 重 写 这 两 个 方法 ， 然后 分 别 在 这 两 个 方法 中 实现 创 
建 和 升级 数据 库 的 逻辑 。 


SQLite0penHeLper 中 还 有 两 个 非常 重要 的 实例 方法 : getReadableDatabase() 和 
getwritableDatabase()。 这 两 个 方法 都 可 以 创建 或 打开 一 个 现 有 的 数据 库 (如 果 数 据 库 已 
存在 则 直接 打开 ， 否则 要 创建 一 个 新 的 数据 库 ) ， 并 返回 一 个 可 对 数据 库 进行 读 写 操作 的 对 
象 。 不 同 的 是 ， 当 数据 库 不 可 写 入 的 时 候 (如 磁盘 空间 已 满 ) ，getReadableDatabase() 方 
法 返回 的 对 象 将 以 只 读 的 方式 打开 数据 库 ， 而 getWritabLeDatabase() 方 法 则 将 出 现 异 常 。 


SQLite0penHeLper 中 有 两 个 构造 方法 可 供 重 写 ， 一 般 使 用 参数 少 一 点 的 那个 构造 方法 即 可 。 
这 个 构造 方法 中 接收 4 个 参数 : 第 一 个 参数 是 Context , 这 个 没什么 好 说 的 ， 必 须 有 它 才能 对 数 
据 库 进 行 操作 ; 第 二 个 参数 是 数据 库 名 ， 创 建 数据 库 时 使 用 的 就 是 这 里 指定 的 名 称 ; 第 三 个 参 
数 允 许 我 们 在 查询 数据 的 时 候 返 回 一 个 自 定义 的 Cursor , 一般 传 入 nuLL 即 可 ; 第 四 个 参数 表示 
当前 数据 库 的 版 本 号 ， 可 用 于 对 数据 库 进 行 升级 操作 。 构 建 出 SQLite0penHeLper 的 实例 之 
后 ， 再 调用 它 的 getReadabLeDatabase() 或 getWritabLeDatabase( ) 方 法 就 能 够 创建 数 
据 库 了 ， 数 据 库 文 件 会 存放 在 /data/data/<package name>/databases/ 目 录 下 。 此 时 , 重 
写 的 onCreate ( ) 方 法 也 会 得 到 执行 ， 所 以 通常 会 在 这 里 处 理 一 些 创 建 表 的 逻辑 。 
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接 下 来 还 是 让 我 们 通过 具体 的 例子 来 更 加 直观 地 体会 SQLite0penHelper 的 用 法 吧 ,首先 新 建 
一 个 DatabaseTest 项 目 。 


这 里 我 们 希望 创建 一 个 名 为 BookStore.db 的 数据 库 ， 然 后 在 这 个 数据 库 中 新 建 一 张 Book 表 ， 
表 中 有 id (主键 ) 、 作 者 、 价 格 、 页 数 和 书 名 等 列 。 创 建 数据 库 表 当然 还 是 需要 用 建 表 语句 的 ， 
这 里 就 要 考验 一 下 你 的 SQL 基本 功 了 ，Book 表 的 建 表 语 名 如 下 所 示 : 


create table Book ( 
id integer primary key autoincrement， 
author text, 
price real, 
pages integer， 
name text) 


只 要 你 对 SQL 方面 的 知识 稍微 有 一 些 了 解 ， 上 面 的 建 表 语句 对 你 来 说 应 该 不 难 吧 。SQLite 不 像 
其 他 的 数据 库 拥有 众多 繁杂 的 数据 类 型 ， 它 的 数据 类 型 很 简单 : integer 表 示 整 型 ，real 表 示 
浮 点 型 ,text 表示 文本 类 型 ,blob 表示 二 进 制 类 型 。 另 外 ， 在 上 述 建 表 语 句 中， 我 们 还 使 用 了 
primary key 将 id 列 设 为 主键， 并 用 autoincrement 关 键 字 表示 id 列 是 自 增 长 的 。 


然后 需要 在 代码 中 执行 这 条 SQL 语句 ， 才 能 完成 创建 表 的 操作 。 新 建 MyDatabaseHeLper 类 继 
承 自 SQLite0penHeLper , 代码 如 下 所 示 : 


class MyDatabaseHelper(val context: Context, name: String, version: Int) : 
SQLiteOpenHelper(context, name, null, version) { 


private val createBook = "create table Book ("+ 
" id integer primary key autoincrement," + 
"author text," + 
"price real," + 
"pages integer," + 
"name text)" 


override fun onCreate(db: SQLiteDatabase) { 
db.execSQL (createBook) 


Toast.makeText(context, "Create succeeded", Toast.LENGTH SHORT).show() 
} 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { 


} 


可 以 看 到 ,我们 把 建 表 语句 定义 成 了 一 个 字符 串 变 量 ,然后 在 onCreate( ) 方 法 中 又 调用 了 
SQLiteDatabase 的 execSQL() 方 法 去 执行 这 条 建 表 语 句 ， 并 弹出 一 个 Toast 提 示 创 建成 功 ， 
这 样 就 可 以 保证 在 数据 库 创建 完成 的 同时 还 能 成 功 创建 Book 表 。 


现在 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
en 


<Button 
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android:id="@+id/createDatabase" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Create Database" 

/> 


</LinearLayout> 


布局 文件 很 简单 ， 就 是 加 入 了 一 个 按钮 ， 用 于 创建 数据 库 。 最 后 修改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 1) 
createDatabase.setOnClickListener { 
dbHelper.writableDatabase 


} 


} 


这 里 我 们 在 onCreate( ) 方 法 中 构建 了 一 个 MyDatabaseHeLper 对 象 ， 并 且 通 过 构造 浮 数 的 参 
数 将 数据 库 名 指定 为 BookStore.db， 版 本 号 指定 为 1 ,然后 在 “Create Database” 按 钮 的 点 击 
事件 里 调用 了 getWritableDatabase() 方 法 。 这 样 当 第 一 次 点 击 “Create Database” 按 钮 
时 ,就 会 检测 到 当前 程序 中 并 没有 BookStore.db 这 个 数据 库 ， 于 是 会 创建 该 数据 库 并 调用 
MyDatabaseHelper 中 的 0nCreate() 方 法 ，, 这样 Book 表 也 就 创建 好 了 ， 然 后 会 弹出 一 个 
Toast 提 示 创 建成 功 。 再 次 点 击 “Create Database” 按 钮 时 ， 会 发现 此 时 已 经 存在 
BookStore.db 数 据 库 了 ,因此 不 会 再 创建 一 次 。 


现在 就 可 以 运行 一 下 代码 了 , 在 程序 主 界面 点 击 “Create Database" 按 钮 ， 结 果 如 图 7.10 所 
示 。 
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9:49 © a | 
DatabaseTest 


CREATE DATABASE 


Create succeeded 


图 7.10 ”创建 数据 库 成 功 


此 时 BookStore.db 数 据 库 和 Book 表 应 该 已 经 创建 成 功 了 ， 因 为 当 你 再 次 点 击 “Create 
Database" 按 钮 时 ,不 会 再 有 Toast 弹 出 。 可 是 又 回 到 了 之 前 的 那个 老 问题 : 怎样 才能 证 实 它们 
的 确 创建 成 功 了 ? 


这 里 我 们 仍然 还 是 可 以 使 用 Device File Explorer , 但 是 这 个 工具 最 多 只 能 看 到 databases 目 
录 下 出 现 了 一 个 BookStore.db 文 件 ， 是 无 法 查看 Book 表 的 。 因 此 我 们 还 需要 借助 一 个 叫 作 
Database Navigator 的 插件 工具 。 


Android Studio 是 基于 Intellij IDEA 进 行 开发 的 ， 因 此 Intellij IDEA 中 各 种 丰富 的 插件 在 
Android Studio 中 也 可 以 使 用 。 从 Android Studio 导 航 栏 中 打开 PreferencesPlugins ,就 
可 以 进入 插件 管理 界面 了 ， 如 图 7.11 所 示 。 
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四 9 Preferences 


Plugins Marketplace Installed Updates 次 


Dn 


EE Qr search plugins in marketplace 


Appearance 


Featured Show All 
Menus and Toolbars 
System Settings ldeavim ADB dea CodeGlance 
Passwords Editor Tools integration 


HTTP Proxy 
Data Sharing 


Updates 
Android SDK Install | [ Install 


File Colors 

Scopes 

Notifications Android ButterKnife Zele... Material Theme UI Flutter 
Quick Lists 
Path Variables 

Keymap 

Editor 


Version Control 


Install ] 


L 


Build, Execution, Deployment Genymotion DTO generator 
Languages & Frameworks Misc c 

Tools 

Kotlin Compiler 


Experimental 


C 全 37 CF 4.2K 
Install | Install ] Install | 


图 7.11 插件 管理 界面 


这 是 一 个 官方 的 插件 市 场 ， 你 只 需要 在 搜索 框 中 输入 “Database Navigator”, 即 可 找到 我 们 
需要 的 插件 ， 如 图 7.12 所 示 。 


Q~ Database Navigator 


Search Results (6) 


Database Navigator 
Database 


Database development, scripting 
and navigation tool This product 
adds extensive database... 


C 七 月 07,2019 1.8M 女 4.3 
Install 


图 7.12 Database Navigator 插 件 


点 击 “Install”, Android Studio 会 自动 下 载 并 安装 插件 ， 安 装 完成 后 根据 提示 重启 Android 
Studio， 新 安装 的 插件 就 可 以 正常 工作 了 。 


现在 打开 Device File Explorer , 然后 进 
入 /data/data/com.example.dqatabasetest/databases/ 目 录 下 ， 可 以 看 到 已 经 存在 了 一 -7 
BookStore.db 文 件 ， 如 图 7.13 所 示 。 
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Device File Explorer 你 一 
团 Emulator Pixel_APL29 Android 10, API 29 v 


Name Permissions | Date Size 
com.example.broadcastbestpr: drwxrwx--x 2019-06-12 07:47 4KB 
com.example.broadcasttest drwxrwx--x 2019-06-12 07:47 4 KB 
com.example.databasetest drwxrwx--x 2019-06-12 07:47 4 KB 


cache drwxrws--x 2019-07-08 21:49 4KB 
code_cache drwxrws--x 2019-07-08 21:49 4 KB 
databases drwxrwx--x 2019-07-08 21:49 4KB 


BookStore.db -rW-rW---- 2019-07-08 21:49 20 KB 


”BookStore.db-journal -rw-rw---- 2019-07-08 21:49 0B 
com.example.filepersistencetes drwxrwx--x 2019-06-12 07:47 4 KB 
com.example.fragmentbestpral drwxrwx--x 2019-06-12 07:47 4 KB 


图 7.13 ”生成 的 BookStore.db 文 件 


这 个 目录 下 还 存在 另外 一 个 BookStore.db-journal 文 件 ， 这 是 一 个 为 了 让 数据 库 能 够 支持 事务 
而 产生 的 临时 日 志文 件 ， 通常 情况 下 这 个 文件 的 大 小 是 0 字 节 ,我 们 可 以 暂时 不 用 管 它 。 


现在 对 着 BookStore.db 文 件 右 击 -Save As , 将 它 从 模拟 器 导出 到 你 的 计算 机 的 任意 位 置 。 然 
后 观察 Android Studio 的 左 侧 边栏 ， 现在 应 该 多 出 了 一 个 DB Browser 工 具 ， 这 就 是 我 们 刚刚 
安装 的 插件 了 。 如 果 你 的 左 侧 边栏 中 找 不 到 这 个 工具 ， 也 可 以 使 用 快捷 键 Ctrl + Shift 十 

A (Mac 系 统 是 command + shift + A) 打开 搜索 功能 ， 在 搜索 框 中 输入 “DB Browser" 即 可 
找到 这 个 工具 。 


为 了 打开 刚刚 导出 的 数据 库 文 件 ， 我 们 需要 点 击 这 个 工具 左上 角 的 加 号 按钮 ， 并 选择 SQLite 选 
项 ， 如 图 7.14 所 示 。 


DB Browser 次 一 
i 广 
回 Oracle 
[QW MySsQL 
替 PostgreSQL 


| Custom... 


| Import TNS Names 


gl 
办 


| 4 


图 7.14 在 DB Browser 中 选择 SQLite 


然后 在 弹出 窗口 的 Database 配 置 中 选择 我 们 刚才 导出 的 BookStore.db 文 件 ， 如 图 7.15 所 示 。 
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DB Navigator - Settings 


Connections | Database Browser | Navigation | Code Editor | Code Completion Data Grid | Data Editor | Execution Engine Operations | DDL Files General 


二 一 全 和合 让 妆 


及 connection 


Database SSL SSH Tunnel | Properties T Details | Filters 


Name Connection PB SQLite 


Description 


Database files| /Users/guolin/BookStore.db main 


Driver source Built-in library v 


Active Test Connection Info 


Cancel Apply | ox | 


图 7.15 选择 BookStore.db 文 件 
点 击 “OK” 完 成 配置 ， 这 个 时 候 DB Browser 中 就 会 显示 出 BookStore.db 数 据 库 里 所 有 的 内 容 


了 ,如 图 7.16 所 示 。 


DB Browser 


十 | 4 三 


Connection 


加 | 书城 


证 | 


险 : Schemas (1) 


到 3 main 


睹 Tables (3) 
于 Book 


站 Columns (5) 
id 
Bauthor 
Bname 
pages 
Bprice 

习 Constraints (1) 


1 Indexes 


» Triggers 


3 android_metadata 
3 sqlite_sequence 
王 Views 


图 7.16 BookStore.db 数 据 库 中 的 内 容 


可 以 看 到 ,BookStore.db 数 据 库 中 确实 存在 了 一 张 Book 表 ,并 且 Book 表 中 的 列 也 和 我 们 前 面 
使 用 的 建 表 语句 完全 匹配 ， 由 此 证 明 BookStore.db 数 据 库 和 Book 表 确实 已 经 创建 成 功 了 。 
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7.4.2 ”升级 数据 库 


如 果 你 足够 细心 ， 一 定 会 发 现 MyDatabaseHeLper 中 还 有 一 个 空 方法 呢 ! 没 错 ， 
onUpgrade () 方 法 是 用 于 对 数据 库 进 行 升级 的 ， 它 在 整个 数据 库 的 管理 工作 当中 起 着 非常 重要 
的 作用 ， 可 和 干 万 不 能 忽视 它 哟 。 


目前 , DatabaseTest 项 目 中 已 经 有 一 张 Book 表 用 于 存放 书 的 各 种 详细 数据 ， 如 果 我 们 想 再 添 
加 一 张 Category 表 用 于 记录 图 书 的 分 类 ， 该 怎么 做 呢 ? 


比如 Category 表 中 有 :id (主键 ) 、 分 类 名 和 分 类 代码 这 几 个 列 ， 那 么 建 表 语 名 就 可 以 写成 : 


Create table Category ( 
id integer primary key autoincrement， 
category_name text, 
category _ code integer) 


接 下 来 我 们 将 这 条 建 表 语句 添加 到 MyDatabaseHeLper 中 ， 代 码 如 下 所 示 : 


class MyDatabaseHelper(val context: Context, name: String, version: Int) : 
SQLiteOpenHelper(context, name, null, version) { 


private val createCategory = "create table Category ("+ 
"id integer primary key autoincrement," + 
"category name text," + 
"category code integer)" 


override fun onCreate(db: SQLiteDatabase) { 

db.execSQL (createBook) 

db.execSQL (createCategory) 

Toast.makeText(context, "Create succeeded", Toast.LENGTH SHORT).show() 
} 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { 


} 


看 上 去 好 像 都 挺 对 的 吧 ? 现在 我 们 重新 运行 一 下 程序 ， 并 点 击 “Create Database" 按 钮 ， 喷 ? 
竟然 没有 弹出 创建 成 功 的 提示 。 当 然 ， 你 也 可 以 通过 DB Browser 工 具 到 数据 库 中 再 去 检查 一 
下 ， 这样 你 会 更 加 确认 Category 表 没有 创建 成 功 ! 


其 实 没 有 创建 成 功 的 原因 不 难 思考 ， 因 为 此 时 BookStore.db 数 据 库 已 经 存在 了 ， 之 后 不 管 我 们 
怎样 点 击 “Create Database'" 按 钮 ，MyDatabaseHeLper 中 的 onCreate ( ) 方 法 都 不 会 再 次 
执行 ， 因 此 新 添加 的 表 也 就 无 法 得 到 创建 了 。 


解决 这 个 问题 的 办 法 也 相当 简单 ， 只 需要 先 将 程序 卸载 ， 然 后 重新 运行 ， 这 时 BookStore.db 数 
据 库 已 经 不 存在 了 ， 如 果 再 点 击 “Create Database" 按 钮 ,MyDatabaseHeLper 中 的 
onCreate ( ) 方 法 就 会 执行 ,这 时 Category 表 就 可 以 创建 成 功 了 。 


不 过 ， 通 过 印 载 程序 的 方式 来 新 增 一 张 表 富 无 疑问 是 很 极端 的 做 法 ， 其 实 我 们 只 需要 巧妙 地 运 


用 SQLite0penHeLper 的 升级 功能 ， 就 可 以 很 轻松 地 解决 这 个 问题 。 修 改 
MyDatabaseHelper 中 的 代码 ， 如 下 所 示 : 
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class MyDatabaseHelper(val context: Context, name: String, version: Int) : 
SQLiteOpenHelper(context, name, null, version) { 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { 
db.execSQL("drop table if exists Book") 
db.execSQL("drop table if exists Category") 
onCreate (db) 


} 
可 以 看 到 ， 我 们 在 onUpgrade ( ) 方 法 中 执行 了 两 条 DROP 语 名 ， 如果 发 现 数 据 库 中 已 经 存在 


Book 表 或 Category 表 ， 就 将 这 两 张 表 删除 ， 然后 调用 onCreate( ) 方 法 重新 创建 。 这 里 先 将 
已 经 存在 的 表 删 除 ， 是 因为 如 果 在 创建 表 时 发 现 这 张 表 已 经 存在 了 ， 就 会 直接 报错 。 


接 下 来 的 问题 就 是 如 何 让 onUpgrade( ) 方 法 能 够 执行 了 。 还 记得 SQLite0penHelper 的 构造 
方法 里 接收 的 第 四 个 参数 吗 ? 它 表 示 当 前 数据 库 的 版 本 号 ， 之 前 我 们 传 入 的 是 1， 现在 只 要 传 入 
一 个 比 1 大 的 数 ， 就 可 以 让 onUpgrade ( ) 方 法 得 到 执行 了 。 修 改 MainActivity 中 的 代码 ， 如 下 


所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 2) 
createDatabase.setOnClickListener { 
dbHelper.writableDatabase 


} 
} 


} 


这 里 将 数据 库 版 本 号 指定 为 2， 表示 我 们 对 数据 库 进 行 升级 了 。 现 在 重新 运行 程序 ， 并 点 
击 “Create Database" 按 钮 ， 这 时 就 会 再 次 弹出 创建 成 功 的 提示 。 


为 了 验证 一 下 Category 表 是 不 是 已 经 创建 成 功 了 ,我 们 还 可 以 使 用 同样 的 方式 将 
BookStore.db 文 件 导出 到 计算 机 本 地 ， 并 覆盖 之 前 的 BookStore.db 文 件 , 然后 在 DB 
Browser 中 重新 导入 ， 这 样 就 会 加 载 新 的 BookStore.db 文 件 了 ， 如 图 7.17 所 示 。 
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图 7.17 BookStore.db 数 据 库 升 级 后 的 内 容 
可 以 看 到 ,， Category 表 已 经 创建 成 功 了 ， 说 明 我 们 的 升级 功能 的 确 起 到 了 作用 。 
7.4.3 添加 数据 


现在 你 已 经 掌握 了 创建 和 升级 数据 库 的 方法 ， 接 下 来 就 该 学 习 一 下 如 何 对 表 中 的 数据 进行 操作 
了 。 其 实 我 们 可 以 对 数据 进行 的 操作 无 非 有 4 种 ， 即 CRUD。 其 中 C 代 表 添 加 (create) ，R 代 
表 查 询 (retrieve) ，U 代 表 更 新 (update) ，D 代 表 删 除 (delete) 。 每 一 种 操作 都 对 应 了 
一 种 SQL 命 令 ， 如 果 你 比较 熟悉 SQL 语 言 的 话 ， 一定 会 知道 添加 数据 时 使 用 insert ,查询 数据 
时 使 用 select ,更 新 数据 时 使 用 update， 删除 数据 时 使 用 delete。 但 是 开发 者 的 水 平 是 参差 
不 齐 的 ， 未 必 每 一 个 人 都 能 非常 熟悉 SQL 语言 ， 因 此 Android 提 供 了 一 系列 的 辅助 性 方法 ， 让 你 
在 Android 中 即使 不 用 编写 SQL 语句 ， 也 能 轻松 完成 所 有 的 CRUD 操 作 。 


前 面 我 们 已 经 知道 ， 调 用 SQLite0penHeLper 的 getReadabLeDatabase() 或 
getWritabLeDatabase( ) 方 法 是 可 以 用 于 创建 和 升级 数据 库 的 ， 不 仅 如 此 ,这 两 个 方法 还 都 
会 返回 一 个 SQLiteDatabase 对 象 ， 借 助 这 个 对 象 就 可 以 对 数据 进行 CRUD 操 作 了 。 


那么 下 面 我 们 首先 学 习 一 下 如 何 向 数据 库 的 表 中 添加 数据 吧 。SQLiteDatabase 中 提供 了 一 个 
insert() 方 法 ， 专 门 用 于 添加 数据 。 它 接收 3 个 参数 : 第 一 个 参数 是 表 名 ， 我 们 希望 向 哪 张 表 
里 添加 数据 ， 这 里 就 传 入 该 表 的 名 字 ; 第 二 个 参数 用 于 在 未 指定 添加 数据 的 情况 下 给 某 些 可 为 
空 的 列 自动 赋值 NULL , 一 般 我 们 用 不 到 这 个 功能 ,直接 传 入 null 即 可 ; 第 三 个 参数 是 一 个 
ContentValues 对 象 ， 它 提供 了 一 系列 的 put( ) 方 法 重 载 ， 用 于 向 ContentValues 中 添加 数 
据 ， 只 需要 将 表 中 的 每 个 列 名 以 及 相应 的 待 添加 数据 传 入 即 可 。 


介绍 完了 基本 用 法 ， 接 下 来 还 是 让 我 们 通过 例子 来 亲身 体验 一 下 如 何 添加 数据 吧 。 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
> 


<Button 
android:id="@+id/addData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Add Data" 
/> 
</LinearLayout> 


可 以 看 到 ， 我们 在 布局 文件 中 又 新 增 了 一 个 按钮 , 稍 后 就 会 在 这 个 按钮 的 点 击 事件 里 编写 添加 
数据 的 逻辑 。 接 着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 2) 


addData.setOnClickListener { 
val db = dbHelper.writableDatabase 
val valuesl = ContentValues().apply { 
// 开始 组 装 第 一 条 数据 
put("name", "The Da Vinci Code") 
put("author", "Dan Brown") 
put ("pages", 454) 
put("price", 16.96) 


} 
db.insert("Book"，null，valuesl) // 插入 第 一 条 数据 
val values2 = ContentValues().apply { 
// 开始 组 装 第 二 条 数据 
put("name", "The Lost Symbol") 
put("author", "Dan Brown") 
put("pages", 510) 
put("price", 19.95) 


} 
db.insert("Book"，null，values2) // 插入 第 二 条 数据 


} 


在 添加 数据 按钮 的 点 击 事件 里 ， 我 们 先 获 取 了 SQLiteDatabase 对 象 ,然后 使 用 
ContentValues 对 要 添加 的 数据 进行 组 装 。 如 果 你 比较 细心 的 话 ， 应 该 会 发 现 这 里 只 对 Book 
表 里 其 中 4 列 的 数据 进行 了 组 装 ，id 那 一 列 并 没 给 它 赋值 。 这 是 因为 在 前 面 创建 表 的 时 候 ,我们 
就 将 id 列 设置 为 自 增长 了 ， 它 的 值 会 在 入 库 的 时 候 自 动 生成 ， 所 以 不 需要 手动 赋值 了 。 接 下 来 调 
用 了 insert () 方 法 将 数据 添加 到 表 当 中 ， 注 意 这 里 我 们 添加 了 两 条 数据 。 


好 了 ， 现在 可 以 重新 运行 一 下 程序 了 ， 界 面 如 图 7.18 所 示 。 
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9:31 © > 
DatabaseTest 
CREATE DATABASE 


ADD DATA 


图 7.18 ”加 入 添加 数据 按钮 


点 击 一 下 “Add Data" 按 钮 ， 此 时 两 条 数据 应 该 都 已 经 添加 成 功 了 。 我 们 仍然 可 以 使 用 DB 
Browser 来 验证 一 下 ， 同 样 先 将 BookStore.db 文 件 导 出 到 本 地 ， 然 后 重新 加 载 数据 库 ， 想 要 查 
询 哪 张 表 的 内 容 ， 只 需要 双击 这 张 表 就 可 以 了 ,这 里 我 们 双击 Book 表 ， 会 弹出 一 个 如 图 7.19 所 
示 的 窗口 。 
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图 7.19 ”设置 查询 条 件 的 窗口 


这 个 窗口 是 用 来 设置 查询 条 件 的 ， 这 里 我 们 不 需要 设置 任何 查询 条 件 ， 直 接点 击 窗口 下 方 的 “No 
Filter" 按 钮 即 可 ， 然 后 就 可 以 看 到 如 图 7.20 所 示 的 数据 了 。 


司 Book 
日 QQ 5 NoFiter vy | 受 5 欠 栈 党 
id author price pages name 
1 Dan Brown 16.96 454 The Da Vinci Code 


Dan Brown 19.95 510 The Lost Symbol 
图 7.20 ”Book 表 中 的 数据 
由 此 可 以 看 出 ， 我 们 刚刚 组 装 的 两 条 数据 都 已 经 准确 无 误 地 添加 到 Book 表 中 了 。 


7.4.4 更 新 数据 


学 习 完了 如 何 向 表 中 添加 数据 ， 接 下 来 我 们 看 看 怎样 才能 修改 表 中 已 有 的 数据 。 
SQLiteDatabase 中 提供 了 一 个 非常 好 用 的 update( ) 方 法 ， 用 于 对 数据 进行 更 新 。 这 个 方法 
接收 4 个 参数 : 第 一 个 参数 和 insert ( ) 方 法 一 样 ,也 是 表 名 ， 指定 更 新 哪 张 表 里 的 数据 ; 第 二 
个 参数 是 ContentVaLues 对 象 ， 要 把 更 新 数据 在 这 里 组 装 进 去 ; 第 三 、 第 四 个 参数 用 于 约束 更 
新 某 一 行 或 某 几 行 中 的 数据 ， 不 指定 的 话 默认 会 更 新 所 有 行 。 


那么 接 下 来 ， 我 们 仍然 是 在 DatabaseTest 项 目的 基础 上 修改 ， 看 一 下 更 新 数据 的 具体 用 法 。 比 
如 刚才 添加 到 数据 库 里 的 第 一 本 书 ， 由 于 过 了 畅销 季 , 卖 得 不 是 很 火 了 ， 现 在 需要 通过 降低 价 
格 的 方式 来 吸引 更 多 的 顾客 ， 我 们 应 该 怎么 操作 呢 ? 首先 修改 activity_main.xml 中 的 代码 ， 如 
下 所 示 : 


www.blogss.cn 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
> 


<Button 
android:id="@+id/updateData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Update Data" 
/> 
</LinearLayout> 


布局 文件 中 的 代码 已 经 非常 简单 了 ， 就 是 添加 了 一 个 用 于 更 新 数据 的 按钮 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 2) 


updateData.setOnClickListener { 
val db = dbHelper.writableDatabase 
val values = ContentValues() 
values.put("price", 10.99) 
db.update("Book", values, "name = ?", array0f("The Da Vinci Code")) 


} 


这 里 在 更 新 数据 按钮 的 点 击 事件 里 面 构建 了 一 个 ContentVaLues 对 象 ， 并 且 只 给 它 指定 了 一 组 
数据 ， 说明 我 们 只 是 想 把 价格 这 一 列 的 数据 更 新 成 10.99。 然 后 调用 了 SQLiteDatabase 的 
update( ) 方 法 执行 具体 的 更 新 操作 ， 可 以 看 到 ,这 里 使 用 了 第 三 、 第 四 个 参数 来 指定 具体 更 新 
哪 几 行 。 第 三 个 参数 对 应 的 是 SQL 语句 的 where 部 分 ， 表 示 更 新 所 有 name 等 于 ?的 行 ,而 ?是 一 
个 占 位 符 ， 可 以 通过 第 四 个 参数 提供 的 一 个 字符 串 数组 为 第 三 个 参数 中 的 每 个 占 位 符 指定 相应 
的 内 容 , array0f () 方 法 是 Kotlin 提 供 的 一 种 用 于 便捷 创建 数组 的 内 置 方法 。 因 此 上 述 代 码 想 
表达 的 意图 就 是 将 The Da Vinci Cooe 这 本 书 的 价格 改 成 10.99。 


现在 重新 运行 一 下 程序 ， 界面 如 图 7.21 所 示 。 
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DatabaseTest 


CREATE DATABASE 


ADD DATA 


UPDATE DATA 


图 7.21 加 入 更 新 数据 按钮 


点 击 “Update Data" 按 钮 ， 再 次 使 用 同样 的 操作 方式 查看 Book 表 中 的 数据 情况 ， 结 果 如 图 
7.22 所 示 。 


习 Book x | 
日 QQ 5 NoFiter v | 十 一 访 区 | 状 
id author price pages name 
4 Dan Brown 10.99 454 The Da Vinci Code 
7 Dan Brown 19.95 510 The Lost Symbol 


图 7.22 查看 更 新 后 的 数据 
可 以 看 到 ，The Da Vinci Code 这 本 书 的 价格 已 经 被 成 功 改 为 10.99 了 ，。 


7.4.5 ”删除 数据 
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怎么 样 ? 添加 和 更 新 数据 的 功能 还 挺 简单 的 吧 ， 代码 也 不 多 ， 理 解 起 来 又 容易 ， 那 么 我 们 要 马 
不 停 蹄 地 开始 学 习 下 一 种 操作 了 “， 即 从 表 中 删除 数据 。 


删除 数据 对 你 来 说 应 该 就 更 简单 了 ， 因 为 它 所 需要 用 到 的 知识 点 你 已 经 全 部 学 过 了 。 
SQLiteDatabase 中 提供 了 一 个 delete() 方 法 ,专门 用 于 删除 数据 。 这 个 方法 接收 3 个 参数 : 
第 一 个 参数 仍然 是 表 名 ， 这 个 没什么 好 说 的 ; 第 二 、 第 三 个 参数 用 于 约束 删除 某 一 行 或 某 几 行 
的 数据 ,不 指定 的 话 默认 会 删除 所 有 行 。 


是 不 是 理解 起 来 很 轻松 了 ? 那 我 们 就 继续 动手 实践 吧 ， 修 改 activity_main.xml 中 的 代码 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 


<Button 
android:id="@+id/deleteData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Delete Data" 
/> 
</LinearLayout> 


仍然 是 在 布局 文件 中 添加 了 一 个 按钮 ， 用 于 删除 数据 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 
所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 2) 


deleteData.setOnClickListener { 
val db = dbHelper.writableDatabase 
db.delete("Book", "pages > ?", array0f("500")) 
} 
} 


} 


可 以 看 到 ， 我 们 在 删除 按钮 的 点 击 事件 里 指明 删除 Book 表 中 的 数据 ， 并 且 通 过 第 二 、 第 三 个 参 
数 来 指定 仅 删除 那些 页 数 超过 500 页 的 书 。 当 然 这 个 需求 很 奇怪 ， 这 里 仅仅 是 为 了 做 个 测试 。 你 
可 以 先 查 看 一 下 当前 Book 表 里 的 数据 ， 其 中 The Lost Symbol 这 本 书 的 页 数 超过 了 500 页 ， 
也 就 是 说 当 我 们 点 击 删 除 按钮 时 ， 这 条 记录 应 该 会 被 删除 。 


现在 重新 运行 一 下 程序 ， 界面 如 图 7.23 所 示 。 


www.blogss.cn 


10:49 © 


DatabaseTest 


CREATE DATABASE 
ADD DATA 
UPDATE DATA 


DELETE DATA 


图 7.23 ”加 入 删除 数据 按钮 
点 击 “Delete Data” 按 钮 ， 再 次 查看 表 中 的 数据 情况 ， 结 果 如 图 7.24 所 示 。 


习 Book 
6 Q 5 | 了 NoFiter "| 前 二 三 诊 瞩 类 
id author price pages name 
0 Dan Brown 10.99 454 The Da Vinci Code 
图 7.24 ”查看 删除 后 的 数据 
7.4.6 ”查询 数据 
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终于 到 最 后 一 种 操作 了 “， 掌握 了 查询 数据 的 方法 之 后 ， 你 就 将 数据 库 的 CRUD 操 作 全 部 学 完 
不 过 于 万 不 要 因此 而 放松 ， 因 为 查询 数据 是 CRUD 中 最 复杂 的 一 种 操作 。 


SQL 的 全 称 是 Structured Query Language， 翻译 成 中 文 就 是 结构 化 查询 语言 。 它 的 大 部 分 功 
能 体现 在 “ 查 " 这 个 字 上 ,而 “增删 改 “ 只 是 其 中 的 一 小 部 分 功能 。 由 于 SQL 查询 涉及 的 内 容 实在 
是 太 多 了 “， 因 此 在 这 里 我 不 准备 对 它 展开 讲解 ， 而 是 只 会 介绍 Android 上 的 查询 功能 。 如 果 你 对 
SQL 语言 非常 感 兴 趣 ， 可 以 找 一 本 专门 介绍 SQL 的 书 进行 学 习 。 


相信 你 已 经 猜 到 了 ，SQLiteDatabase 中 还 提供 了 一 个 que ry ( ) 方 法 用 于 对 数据 进行 查询 。 这 
个 方法 的 参数 非常 复杂 ， 最短 的 一 个 方法 重 载 也 需要 传 入 7 个 参数 。 那 我 们 就 先 来 看 一 下 这 7 个 
参数 各 自 的 含义 吧 。 第 一 个 参数 不 用 说 ， 当 然 还 是 表 名 ， 表 示 我 们 希望 从 哪 张 表 中 查询 数据 。 
第 二 个 参数 用 于 指定 去 查询 哪 几 列 ， 如 果 不 指定 则 默认 查询 所 有 列 。 第 三 、 第 四 个 参数 用 于 约 
束 查询 某 一 行 或 某 几 行 的 数据 ， 不 指定 则 默认 查询 所 有 行 的 数据 。 第 五 个 参数 用 于 指定 需要 去 
group by 的 列 ， 不 指定 则 表示 不 对 查询 结果 进行 group by 操作 。 第 六 个 参数 用 于 对 group by 
之 后 的 数据 进行 进一步 的 过 滤 ， 不 指定 则 表示 不 进行 过 滤 。 第 七 个 参数 用 于 指定 查询 结果 的 排 
序 方式 ， 不 指定 则 表示 使 用 默认 的 排序 方式 。 更 多 详细 的 内 容 可 以 参考 表 7.1。 其 他 几 个 
query () 方 法 的 重 载 也 大 同 小 异 ， 你 可 以 自己 去 研究 一 下 ， 这 里 就 不 再 进行 介绍 了 。 


表 7.1 query() 方 法 参数 的 详细 解释 


query() 方 法 参数 对 应 SQL 部 分 描述 
table from table name 指定 查询 的 表 名 
columns select columnl, column2 指定 查询 的 列 名 
selection where column = value 指定 where 的 约束 条 件 
selectionArgs - 为 where 中 的 占 位 符 提供 具体 的 值 
groupBy group by column 指定 需要 group by 的 列 
having having column = value 对 group by 后 的 结果 进一步 约束 
orderBy order by coLumn1，coLumn2 指定 查询 结果 的 排序 方式 


虽然 query ( ) 方 法 的 参数 非常 多 ， 但 是 不 要 对 它 产 生 晴 惧 ， 因 为 我 们 不 必 为 每 条 查询 语句 都 指 
定 所 有 的 参数 ， 多 数 情况 下 只 需要 传 入 少数 几 个 参数 就 可 以 完成 查询 操作 了 。 调 用 query ( ) 方 
法 后 会 返回 一 个 Cursor 对 象 ， 查询 到 的 所 有 数据 都 将 从 这 个 对 象 中 取出 。 


下 面 还 是 让 我 们 通过 具体 的 例子 来 体验 一 下 查询 数据 的 用 法 ， 修 改 activity_main.xml 中 的 代 
码 ， 如 下 所 示 : 
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<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" 
> 


<Button 
android:id="@+id/queryData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Query Data" 
/> 
</LinearLayout> 


这 个 已 经 没什么 好 说 的 了 ， 添 加 了 一 个 按钮 用 于 查询 数据 。 然 后 修改 MainActivity 中 的 代码 ， 
如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 2) 


queryData.setOnClickListener { 
val db = dbHelper.writableDatabase 
// 查询 Book 表 中 所 有 的 数据 
val cursor = db.query("Book", null, null, null, null, null, null) 
if (cursor.moveToFirst()) { 
do { 
// 遍历 Cursor 对 象 ， 取 出 数据 并 打印 
val name = cursor.getString(cursor.getColumnIndex("name")) 
val author = cursor.getString(cursor.getColumnIndex("author")) 
val pages = cursor.getInt(cursor.getColumnIndex("pages")) 
val price = cursor.getDouble(cursor.getColumnIindex("price")) 
Log.d("MainActivity", "book name is $name") 
Log.d("MainActivity", "book author is $author") 
Log.d("MainActivity", "book pages is $pages") 
Log.d("MainActivity", "book price is $price") 
} while (cursor.moveToNext()) 


} 


cursor.close() 


} 


可 以 看 到 ,我们 首先 在 查询 按钮 的 点 击 事件 里 面 调用 了 SQLiteDatabase 的 query ( ) 方 法 查询 
数据 。 这 里 的 que ry ( ) 方 法 非常 简单 ， 只 使 用 了 第 一 个 参数 指明 查询 Book 表 ,后面 的 参数 全 部 
为 nuLL。 这 就 表示 希望 查询 这 张 表 中 的 所 有 数据 ， 虽 然 这 张 表 中 目前 只 剩 下 一 条 数据 了 。 查 询 
完 之 后 就 得 到 了 一 个 Cursor 对 象 ， 接 着 我 们 调用 它 的 moveToFirst ( ) 方 法 ， 将 数据 的 指针 移 
动 到 第 一 行 的 位 置 ， 然 后 进入 一 个 循环 当中 , 去 遍历 查询 到 的 每 一 行 数 据 。 在 这 个 循环 中 可 以 
通过 Cursor 的 getColumnIndex() 方 法 获取 某 一 列 在 表 中 对 应 的 位 置 索引 ,然后 将 这 个 索引 
传 入 相应 的 取 值 方法 中 ， 就 可 以 得 到 从 数据 库 中 读 取 到 的 数据 了 。 接 着 我 们 使 用 Log 将 取出 的 数 
据 打 印 出 来 ， 借 此 检查 读 取 工作 有 没有 成 功 完 成 。 最 后 别 忘 了 调用 cLose ( ) 方 法 来 关闭 


CuUrsor。 
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好 了 ， 现 在 重新 运行 程序 ,界面 如 图 7.25 所 示 。 


9:25 © 
DatabaseTest 
CREATE DATABASE 
ADD DATA 
UPDATE DATA 
DELETE DATA 
QUERY DATA 


图 7.25 加 入 查询 数据 按钮 
点 击 “Query Data” 按 钮 ， 查看 Logcat 的 打印 内 容 ， 结果 如 图 7.26 所 示 。 


com.example.databasetest (14117) 地 Verbose “ 闻 Qr 


1117/com.example.databasetest D/MainActivity: book name is The Da Vinci Code 
1117/com.example.databasetest D/MainActivity: book author is Dan Brown 
1117/com.example.databasetest D/MainActivity: book pages is 454 
1117/com.example.databasetest D/MainActivity: book price is 10.99 


图 7.26 打印 查询 到 的 数据 
可 以 看 到 ， 这 里 已 经 将 Book 表 中 唯一 的 一 条 数据 成 功 地 读 取出 来 了 。 
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当然 ， 这 个 例子 只 是 对 查询 数据 的 用 法 进行 了 最 简单 的 示范 。 在 真正 的 项 目 中 ， 你 可 能 会 遇 到 
比 这 要 复杂 得 多 的 查询 功能 ， 更 多 高 级 的 用 法 还 需要 你 自己 去 慢 慢 摸索 ， 毕竟 que ry ( ) 方 法 中 
还 有 那么 多 的 参数 我 们 都 还 没 用 到 呢 。 

7.4.7 使 用 SQL 操作 数据 库 

虽然 Android 已 经 给 我 们 提供 了 很 多 非常 方便 的 API 用 于 操作 数据 库 ， 不 过 总 会 有 一 些 人 不 习惯 
使 用 这 些 辅助 性 的 方法 ， 而 是 更 加 青睐 于 直接 使 用 SQL 来 操作 数据 库 。 如 果 你 也 是 其 中 之 一 的 


话 ， 那 么 茶 喜 , Android 充 分 考虑 到 了 你 们 的 编程 习惯 ， 同 样 提供 了 一 系列 的 方法 ， 使 得 可 以 直 
接 通 过 SQL 来 操作 数据 库 。 


下 面 我 就 来 简略 演示 一 下 ， 如 何 直 接 使 用 SQL 来 完成 前 面 几 个 小 节 中 学 过 的 CRUD 操 作 。 
添加 数据 : 


db .execSQL("insert into Book (name, author, pages, price) values(?, ?, ?, ?)", 
array0f("The Da Vinci Code", "Dan Brown", "454", "16.96") 


db .execSQL("insert into Book (name, author, pages, price) values(?, ?, ?, ?)", 
array0f("The Lost Symbol", "Dan Brown", "510", "19.95") 


更 新 数据 : 


db .execSQL("update Book set price = ? where name = ?", array0f("10.99", "The Da Vinci Code") 


删除 数据 : 


< 一 


db.execSQL("delete from Book where pages > ?", array0f("500")) 


查询 数据 : 


val _ cursor = db.rawQuery("select * from Book", null) 


可 以 看 到 ， 除 了 查询 数据 的 时 候 调 用 的 是 SQLiteDatabase 的 rawQuery () 方 法 ,其 他 操作 都 
是 调用 的 execSQL() 方 法 。 以 上 演示 的 几 种 方式 的 执行 结果 会 和 前 面 我 们 学 习 的 CRUD 操 作 的 
结果 完全 相同 ， 选 择 使 用 哪 一 种 方式 就 看 你 个 人 的 喜好 了 。 
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7.5 SQLite 数 据 库 的 最 佳 实践 


上 一 节 我 们 只 能 算是 学 习 了 SQLite 数 据 库 的 基本 用 法 ， 如 果 你 想 继续 深入 钻研 ，SQLite 数 据 库 


中 可 拓展 的 知识 就 太 多 了 。 既 然 还 有 那么 多 的 高 级 技巧 在 等 着 我 们 ,自然 又 要 进入 本 章 的 最 佳 
实践 环节 了 。 
7.5.1 使 用 事务 


我 们 知道 ，SQLite 数 据 库 是 支持 事务 的 ， 事 务 的 特性 可 以 保证 让 一 系列 的 操作 要 人 么 全 部 完成 ， 
要 么 一 个 都 不 会 完成 。 那 么 在 什么 情况 下 才 需 要 使 用 事务 呢 ? 想象 以 下 场景 ， 比 如 你 正在 进行 
一 次 转账 操作 ， 银行 会 先 将 转账 的 金额 从 你 的 账户 中 扣除 ， 然 后 再 向 收 款 方 的 账户 中 添加 等 量 
的 金额 。 看 上 去 好 像 没什么 问题 吧 ? 可 是 ， 如 果 当 你 账户 中 的 金额 刚刚 被 扣除 ， 这 时 由 于 一 些 
异常 原因 导致 对 方 收 款 失败 ， 这 一 部 分 钱 就 凭空 消失 了 ! 当然 银行 肯定 已 经 充分 考虑 到 了 这 种 
情况 ， 它 会 保证 扣 款 和 收 款 的 操作 要 人 么 一 起 成 功 ， 要 么 都 不 会 成 功 ， 而 使 用 的 技术 当然 就 是 事 
务 了 。 


接 下 来 我 们 看 一 看 如 何在 Android 中 使 用 事务 吧 ， 仍 然 是 在 DatabaseTest 项 目的 基础 上 进行 修 
改 。 比 如 Book 表 中 的 数据 已 经 很 老 了 ， 现 在 准备 全 部 废弃 ,替换 成 新 数据 ， 可 以 先 使 用 
delete( ) 方 法 将 Book 表 中 的 数据 删除 ， 然 后 再 使 用 insert ( ) 方 法 将 新 的 数据 添加 到 表 中 。 
我 们 要 保证 删除 旧 数 据 和 添加 新 数据 的 操作 必须 一 起 完成 ， 否 则 就 要 继续 保留 原来 的 旧 数 据 。 
修改 activity_main.xml 中 的 代码 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<Button 
android:id="@+id/replaceData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Replace Data" 
/> 
</LinearLayout> 


可 以 看 到 ， 这 里 又 添加 了 一 个 按钮 ,用 于 进行 数据 蔡 换 操作 。 然 后 修改 MainActivity 中 的 代 
码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val dbHelper = MyDatabaseHelper(this, "BookStore.db", 2) 


replaceData.setOnClickListener { 
val db = dbHelper.writableDatabase 
db.beginTransaction() // 开启 事务 
try { 
db.delete("Book", null, null) 
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if (true) { 
// 手动 抛 出 一 个 异常 ， 让 事务 失败 
throw NullPointerException() 


} 

val values = ContentValues().apply { 
put("name", "Game of Thrones") 
put("author", "George Martin") 
put("pages", 720) 
put("price", 20.85) 


db.insert("Book", null, values) 
db.setTransactionSuccessful() // 事务 已 经 执行 成 功 
} catch (e: Exception) { 
e.printStackTrace() 
} finally { 
db.endTransaction() // 结束 事务 


} 
} 
} 


} 


上 述 代码 就 是 Android 中 事务 的 标准 用 法 ， 首先 调用 SQLiteDatabase 的 
beginTransaction() 方 法 开启 一 个 事务 ， 然 后 在 一 个 异常 捕获 的 代码 块 中 执行 具体 的 数据 库 
操作 ， 当 所 有 的 操作 都 完成 之 后 ， 调用 setTransactionSuccessful() 表 示 事 务 已 经 执行 成 
功 了 ，, 最 后 在 finally 代 码 块 中 调用 endTransaction ( ) 结 束 事务 。 注 意 观 察 ， 我 们 在 删除 旧 
数据 的 操作 完成 后 手动 搜 出 了 一 个 NuLLPointerException ,这 样 添加 新 数据 的 代码 就 执行 
不 到 了 。 不 过 由 于 事务 的 存在 ， 中途 出 现 异常 会 导致 事务 的 失败 ， 此 时 旧 数 据 应 该 是 删除 不 掉 
的 。 


现在 运行 一 下 程序 并 点 击 “Replace Data” 按 钮 ,然后 点 击 “Query Data" 按 钮 。 你 会 发 现 ， 
Book 表 中 存在 的 还 是 之 前 的 | 日 数据 ， 说 明 我 们 的 事务 确实 生效 了 。 然 后 将 手动 抛 出 异常 的 那 行 
代码 删除 并 重新 运行 程序 ， 此 时 点 击 一 下 “Replace Data” 按 钮 ,就 会 将 Book 表 中 的 数据 替换 
成 新 数据 了 ， 你 可 以 再 使 用 “Query Data” 按 钮 来 验证 一 次 。 


7.5.2 ”升级 数据 库 的 最 佳 写法 


在 7.4.2 小 节 中 我 们 学 习 的 升级 数据 库 的 方式 是 非常 粗暴 的 ， 为 了 保证 数据 库 中 的 表 是 最 新 的 ， 
我 们 只 是 简单 地 在 onUpgrade ( ) 方 法 中 删除 掉 了 当前 所 有 的 表 ， 然后 强制 重新 执行 了 一 遍 
onCreate( ) 方 法 。 这 种 方式 在 产品 的 开发 阶段 确实 可 以 用 ， 但 是 当 产品 真正 上 线 之 后 就 绝对 
不 行 了 。 想 象 以 下 场景 ， 比 如 你 编写 的 某 个 应 用 已 经 成 功 上 线 了 ， 并 且 还 拥有 了 不 错 的 下 载 
量 。 现 在 由 于 添加 了 新 功能 ， 数 据 库 需要 一 起 升级 ， 结 果 用 户 更 新 了 这 个 版 本 之 后 却 发 现 以 前 
程序 中 存储 的 本 地 数据 全 部 丢失 了 ! 那么 很 遗憾 ， 你 的 用 户 群 体 可 能 已 经 流失 一 大 半 了 。 


听 起 来 好 像 挺 求 怖 的 样子 ， 难 道 在 产品 发 布 出 去 之 后 还 不 能 升级 数据 库 了 ? 当然 不 是 ， 其 实 只 
需要 进行 一 些 合理 的 控制 ， 就 可 以 保证 在 升级 数据 库 的 时 候 数据 并 不 会 丢失 了 。 


下 面 我 们 就 来 学 习 一 下 如 何 实现 这 样 的 功能 。 你 已 经 知道 ， 每 一 个 数据 库 版 本 都 会 对 应 一 个 版 
本 号 ， 当 指定 的 数据 库 版 本 号 大 于 当前 数据 库 版 本 号 的 时 候 ， 就 会 进入 onUpgrade ( ) 方 法 中 执 
行 更 新 操作 。 这 里 需要 为 每 一 个 版 本 号 赋予 其 所 对 应 的 数据 库 变动 ， 然后 在 onUpgrade() 方 法 
中 对 当前 数据 库 的 版 本 号 进行 判断 ,再 执行 相应 的 改变 就 可 以 了 。 
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下 面 就 让 我 们 模拟 一 个 数据 库 升 级 的 案例 ， 还 是 由 MyDatabaseHeLper 类 对 数据 库 进 行 管理 。 
第 1 版 的 程序 要 求 非常 简单 ， 只 需要 创建 一 张 Book 表 。MyDatabaseHelper 中 的 代码 如 下 所 
示 : 


class MyDatabaseHelper(val context: Context, name: String, version: Int) : 
SQLiteOpenHelper(context, name, null, version) { 


private val createBook = "create table Book ("+ 
" id integer primary key autoincrement," + 
"author text," + 
"price real," + 
"pages integer," + 
"name text)" 


override fun onCreate(db: SQLiteDatabase) { 
db.execSQL (createBook) 
} 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { 


} 


过 ， 几 星期 之 后 又 有 了 新 需求 ， 这 次 需要 向 数据 库 中 再 添加 一 张 Category 表 。 于 是 ， 修改 
MyDatabaseHeLper 中 的 代码 ,如 下 所 示 : 


class MyDatabaseHelper(val context: Context, name: String, version: Int) : 
SQLiteOpenHelper(context, name, null, version) { 


private val createBook = "create table Book ("+ 
" id integer primary key autoincrement," + 
"author text," + 
"price real," + 
"pages integer," + 
"name text)" 


private val createCategory = "create table Category ("+ 
"id integer primary key autoincrement," + 
"category name text," + 
"category code integer)" 


override fun onCreate(db: SQLiteDatabase) { 
db.execSQL (createBook) 
db.execSQL (createCategory) 

} 


override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { 
if (oldVersion <= 1) { 
db.execSQL (createCategory) 
} 


} 


可 以 看 到 ,在 onCreate ( ) 方 法 里 我 们 新 增 了 一 条 建 表 语 句 ， 然 后 又 在 onUpgrade ( ) 方 法 中 添 
加 了 一 个 if 判 断 ， 如果 用 户 数 据 库 的 旧版 本 号 小 于 等 于 1 ， 就 只 会 创建 一 张 Category 表 。 


这 样 当 用 户 直 接 安 装 第 2 版 的 程序 时 ， 就 会 进入 onCreate() 方 法 , 将 两 张 表 一 起 创建 。 而 当 用 
户 使 用 第 2 版 的 程序 覆盖 安装 第 1 版 的 程序 时 ， 就 会 进入 升级 数据 库 的 操作 中 ， 此 时 由 于 Book 表 
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已 经 存在 了 ， 因 此 只 需要 创建 一 张 Category 表 即 可 。 


但 是 没 过 多 久 ， 新 的 需求 又 来 了 ， 这 次 要 给 Book 表 和 Category 表 之 间 建 立 关 联 ， 需 要 在 Book 
表 中 添加 一 个 category_id 字 段 。 再 次 修改 MyDatabaseHeLper 中 的 代码 ， 如 下 所 示 : 


class MyDatabaseHelper(val context: Context, name: String, version: Int) : 
SQLiteOpenHelper(context, name, null, version) { 


private val createBook = "create table Book ("+ 
" id integer primary key autoincrement," + 
"author text," + 
"price real," + 
"pages integer," + 
"name text," + 
"category id integer)" 


private val createCategory = "create table Category ("+ 
"id integer primary key autoincrement," + 
"category name text," + 
"category code integer)" 


override fun onCreate(db: SQLiteDatabase) { 
db.execSQL (createBook) 
db.execSQL (createCategory) 
} 
override fun onUpgrade(db: SQLiteDatabase, oldVersion: Int, newVersion: Int) { 
if (oldVersion <= 1) { 
db.execSQL (createCategory) 


} 
if (oldVersion <= 2) { 

db.execSQL("alter table Book add column category id integer") 
} 


} 
} 


可 以 看 人 到， 首先 我 们 在 Book 表 的 建 表 语句 中 添加 了 一 个 category_id 列 ， 这样 当 用 户 直 接 安 
装 第 3 版 的 程序 时 ， 这 个 新 增 的 列 就 已 经 自动 添加 成 功 了 。 然 而 ， 如 果 用 户 之 前 已 经 安装 了 某 一 
版 本 的 程序 ， 现在 需要 履 盖 安装 ， 就 会 进入 升级 数据 库 的 操作 中 。 在 onUpgrade ( ) 方 法 里 ， 我 
们 添加 了 一 个 新 的 条 件 ， 如 果 当 前 数据 库 的 版 本 号 是 2， 就 会 执行 aLter 命 令 , 为 Book 表 新 增 
一 个 category_id 列 。 


这 里 请 注意 一 个 非常 重要 的 细节 : 每 当 升 级 一 个 数据 库 版 本 的 时 候 ,onUpg rade ( ) 方 法 里 都 一 
定 要 写 一 个 相应 的 1f 判 断 语句 。 为 什么 要 这 么 做 呢 ? 这 是 为 了 保证 App 在 跨 版 本 升级 的 时 候 ， 
每 一 次 的 数据 库 修改 都 能 被 全 部 执行 。 比 如 用 户 当 前 是 从 第 2 版 升级 到 第 3 版 ， 那么 只 有 第 二 条 
判断 语句 会 执行 ， 而 如 果 用 户 是 直接 从 第 1 版 升级 到 第 3 版 ， 那么 两 条 判断 语句 都 会 执行 。 使 用 
这 种 方式 来 维护 数据 库 的 升级 ， 不 管 版 本 怎样 更 新 ， 都 可 以 保证 数据 库 的 表 结构 是 最 新 的 ， 而 
且 表 中 的 数据 完全 不 会 丢失 。 


好 了 ， 关 于 SQLite 数 据 库 的 最 佳 实践 部 分 我 们 就 学 到 这 里 。 本 节 中 我 们 学 习 的 是 Android 中 操 
作 数 据 库 最 传统 的 方式 ， 而 实际 上 现在 Google 又 推出 了 一 个 专门 用 于 Android 平 台 的 数据 库 杠 
架 一 一 Room。 相 比 于 传统 的 数据 库 API , Room 的 用 法 要 更 加 复杂 一 些 ， 但 是 却 更 加 科学 和 规 
范 ， 也 更 加 符合 现代 高 质量 App 的 开发 标准 ， 我 们 将 在 第 13 章 中 学 习 这 部 分 内 容 。 
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那么 不 用 多 说 ， 现 在 又 该 进入 我 们 本 章 的 Kotlin 课 堂 了 。 
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7.6 Kotlin 课 堂 : 高 阶 函 数 的 应 用 

在 上 一 章 的 Kotlin 课 堂 中 ， 我 们 学 习 了 高 阶 函 数 应 该 如 何 使 用 ,而 本 章 的 Kotlin 课 党 里， 我 们 将 
会 学 习 高 阶 函 数 具 体 可 以 用 在 哪里 。 这 节 课 的 内 容 会 相对 简单 一 些 ， 前 提 是 你 已 经 将 上 一 节 课 
的 内 容 都 牢 牢 掌握 了 。 


高 阶 函数 非常 适用 于 简化 各 种 API 的 调用 ， 一些 API 的 原 有 用 法 在 使 用 高 阶 函 数 简化 之 后 ， 不 管 
是 在 易 用 性 还 是 可 读 性 方面 ， 都 可 能 会 有 很 大 的 提升 。 


为 了 进行 举例 说 明 ,我们 在 本 节 Kotlin 课 党 里 会 使 用 高 阶 消 数 简化 SharedPreferences 和 
ContentVaLues 这 两 种 API 的 用 法 ， 让 它们 的 使 用 变 得 更 加 简单 。 


7.6.1 简化 SharedPreferences 的 用 法 


首先 来 看 SharedPrefe rences，, 在 开始 对 它 进行 简化 之 前 ， 我们 先 回 顾 一 下 
SharedPreferences 原 来 的 用 法 。 向 SharedPreferences 中 存储 数据 的 过 程 大 致 可 以 分 为 
以 下 3 步 : 


(1) 调用 SharedPreferences 的 edit() 方 法 获取 SharedPreferences .Editor 对 象 ; 
(2) 向 SharedPreferences .Editor 对 象 中 添加 数据 ; 

(3) 调用 apptLy ( ) 方 法 将 添加 的 数据 提交 ， 完 成 数据 存储 操作 。 

对 应 的 代码 示例 如 下 : 


val editor = getSharedPreferences("data", Context.MODE PRIVATE) .edit() 
editor.putString("name", "Tom") 

editor.putInt("age", 28) 

editor.putBoolean("married", false) 

editor.apply() 


当然 ， 这 段 代 码 其 实 本 身 已 经 足够 简单 了 ， 但 是 这 种 写法 更 多 还 是 在 用 java 的 编程 思维 来 编写 
代码 ， 而 在 Kotlin 当 中 我 们 明显 可 以 做 到 更 好 。 


接 下 来 我 们 就 尝试 使 用 高 阶 函 数 简 化 SharedPreferences 的 用 法 ， 新 建 一 个 
SharedPreferences.kt 文 件 ， 然 后 在 里 面 加 入 如 下 代码 : 


fun SharedPreferences.open(block: SharedPreferences.Editor.() -> Unit) { 
val editor = edit() 
editor.block() 
editor.apply() 


} 


这 段 代 码 虽然 不 长 ， 但 是 涵盖 了 高 阶 函 数 的 各 种 精华 ， 下 面 我 来 解释 一 下 。 
首先 ， 我 们 通过 扩展 函数 的 方式 向 SharedPreferences 类 中 添加 了 一 个 open 上 子 数 ， 并 且 它 还 
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由 于 open 项 数 内 拥有 SharedPreferences 的 上 下 文 ， 因 此 这 里 可 以 直接 调用 edit ( ) 方 法 来 
获取 SharedPreferences .Editor 对 象 。 另 外 open 函 数 接收 的 是 一 个 
SharedPreferences .Editor 的 函数 类 型 参数 ， 因 此 这 里 需要 调用 editor .block( ) 对 函数 
类 型 参数 进行 调用 ， 我 们 就 可 以 在 函数 类 型 参数 的 具体 实现 中 添加 数据 了 。 最 后 还 要 调用 
editor.apply() 方 法 来 提交 数据 ， 从 而 完成 数据 存储 操作 。 


如 果 你 将 上 一 节 Kotlin 课 堂 的 内 容 很 好 地 掌握 了 ， 相 信 这 段 代码 理解 起 来 应 该 没有 什么 难度 。 


定义 好 了 open 函 数 之 后 ， 我们 以 后 在 项 目 中 使 用 SharedPreferences 存 储 数据 就 会 更 加 方便 
了 ， 写 法 如 下 所 示 : 


getSharedPreferences("data", Context.MODE PRIVATE) .open { 
putString("name", "Tom") 
putInt("age", 28) 
putBoolean("married", false) 


} 


可 以 看 到 ， 我 们 可 以 直接 在 SharedPreferences 对 象 上 调用 open 函 数 ， 然 后 在 Lambda 表 达 
式 中 完成 数据 的 添加 操作 。 注 意 ,现在 Lambda 表 达 式 拥有 的 是 
SharedPreferences.Editor 的 上 下 文 环境 ， 因 此 这 里 可 以 直接 调用 相应 的 put 方 法 来 添加 
数据 。 最 后 我 们 也 不 再 需要 调用 appLy ( ) 方 法 来 提交 数据 了 ， 因 为 0open 销 数 会 自动 完成 提交 操 
作 : 


怎么 样 ， 使 用 高 阶 函 数 简 化 之 后 ， 不管 是 在 易 用 性 还 是 在 可 读 性 上 ,SharedPreferences 的 
用 法 是 不 是 都 简化 了 很 多 ? 这 就 是 高 阶 函数 的 魅力 所 在 。 好 好 掌握 这 个 知识 点 ， 以 后 在 诸多 其 
他 API 的 使 用 方面 ， 我们 都 可 以 使 用 这 个 技巧 ， 让 API 变 得 更 加 简单 。 


当然 ， 最 后 不 得 不 提 的 是 ， 其 实 Google 提 供 的 KTX 扩 展 库 中 已 经 包含 了 上 述 
SharedPreferences 的 简化 用 法 ， 这 个 扩展 库 会 在 Android Studio 创 建 项 目的 时 候 自动 引入 
build.gradle 的 dependencies 中 ， 如 图 7.27 所 示 。 


dependencies { 
implementation fileTree(dir: 'libs', include: ['*.jar’']) 


imp lementation “androldx.constralntLayout:constraintLayout:1.1.3' 
testImplementation ‘junit:junit:4.12' 

androidTestImplementation ‘androidx.test:runner:1.2.0' 
androidTestImplementation '“androidx.test.espresso:espresso-core:3.2.0' 


} 
图 7.27 ”自动 引入 的 KTX 扩 展 库 
因此 ,我们 实际 上 可 以 直接 在 项 目 中 使 用 如 下 写法 来 向 SharedPreferences 存 储 数据 : 


getSharedPreferences("data", Context,.MODE PRIVATE) .edit { 
putString("name", "Tom") 
putInt("age", 28) 
putBoolean("married", false) 


www.blogss.cn 


可 以 看 到 ， 其实 就 是 将 open 也 数 换 成 了 edit 哨 数 ， 但 是 edit 哨 数 的 语义 性 明显 要 更 好 一 些 。 
当然 ， 我 前 面 命名 成 open 函 数 ， 主要 是 为 了 防止 和 KTX 的 edit 函 数 同 名 ， 以 免 你 在 理解 的 时 候 
产生 混淆 。 

那么 你 可 能 会 问 了 ， 既然 Google 的 KTX 库 中 已 经 自 带 了 一 个 edit 吻 数 ， 我们 为 什么 还 编 与 这 个 
open 函 数 呢 ? 这 是 因为 我 希望 你 对 于 高 阶 限 数 的 理解 不 要 仪 仪 停留 在 使 用 的 层面 ,而 是 要 知 其 
然 也 知 其 所 以 然 。KTX 中 提供 的 功能 必然 是 有 限 的 ， 但 是 掌握 了 它们 背后 的 实现 原理 ， 你 将 可 以 
对 无 限 的 API 进 行 更 多 的 扩展 。 


7.6.2 简化 ContentVaLues 的 用 法 
接 下 来 我 们 开始 学 习 如 何 简 化 ContentVatLues 的 用 法 。 


ContentValues 的 基本 用 法 在 7.4 节 中 已 经 学 过 了 ， 它 主要 用 于 结合 SQLiteDatabase 的 API 
存储 和 修改 数据 库 中 的 数据 ， 具体 的 用 法 示例 如 下 : 


val values = ContentValues() 


values.put("name", "Game of Thrones") 
values.put("author", "George Martin") 
values.put("pages", 720) 
values.put("price", 20.85) 
db.insert("Book", null, values) 


你 可 能 会 说 ,这 段 代码 可 以 使 用 apply 少 数 进行 简化 。 这 当然 没有 错 ， 只 是 我 们 其 实 还 可 以 做 
到 更 好 。 


不 过 在 正式 开始 我 们 的 简化 之 旅 之 前 ， 我 还 得 向 你 介绍 一 个 额外 的 知识 点 。 还 记得 在 2.6.1 小 节 
中 学 过 的 map0f ( ) 函数 的 用 法 吗 ? 它 允 许 我 们 使 用 "AppLe" to 1 这 样 的 语法 结构 快速 创建 一 
个 键 值 对 。 这 里 我 先 为 你 进行 部 分 解密 ,在 Kotlin 中 使 用 A_ to B 这 样 的 语法 结构 会 创建 一 个 
Pair 对 象 ， 暂时 你 只 需要 知道 这 些 就 可 以 了 ， 至 于 为 什么 ， 我们 将 在 第 9 章 的 Kotlin 课 堂 中 学 
习 。 


有 了 这 个 知识 前 提 之 后 ， 就 可 以 进行 下 一 步 了 。 新 建 一 个 ContentValues.kt 文 件 ， 然后 在 里 面 
定义 一 个 cvOf ( ) 方 法 ， 如 下 所 示 : 


fun cvof(vararg pairs: Pair<String, Any?>): ContentValues { 
} 


这 个 方法 的 作用 是 构建 一 个 ContentValues 对 象 ， 有 几 点 我 需要 解释 一 下 。 首 先 , cv0f() 方 
法 接收 了 一 个 Pair 参 数 ， 也 就 是 使 用 A to Bi 语法 结构 创建 出 来 的 参数 类 型 ， 但 是 我 们 在 参数 
前 面 加 上 了 一 个 vararg 关 键 字 , 这 是 什么 意思 呢 ? 其 实 vararg 对 应 的 就 是 java 中 的 可 变 参 数 
列表 ,我 们 允许 向 这 个 方法 传 入 0 个 、1 个 、2 个 甚至 任意 多 个 Pair 类 型 的 参数 ， 这些 参数 都 会 
被 赋值 到 使 用 vararg 声 明 的 这 一 个 变量 上 面 ， 然 后 使 用 for- in 循环 可 以 将 传 入 的 所 有 参数 饥 
历 出 来 。 

再 来 看 声明 的 Pair 类 型 。 由 于 Pair 是 一 种 键 值 对 的 数据 结构 ， 因 此 需要 通过 泛 型 来 指定 它 的 键 


和 值 分 别 对 应 什么 类 型 的 数据 。 值 得 庆幸 的 是 ，ContentVaLues 的 所 有 键 都 是 字符 串 类 型 的 ， 
这 里 可 以 直接 将 Pai r 键 的 泛 型 指定 成 String。 但 ContentVaLues 的 值 却 可 以 有 多 种 类 型 ( 字 
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符 串 型 、 整 型 、 浮 点 型 ， 甚 至 是 nuLL) ， 所 以 我 们 需要 将 Pair 值 的 泛 型 指定 成 Any?。 这 是 因 
为 Any 是 Kotlin 中 所 有 类 的 共同 基 类 ， 相 当 于 Java 中 的 0bject ,而 Any? 则 表示 人 允许 传 入 空 值 。 


接 下 来 我 们 开始 为 cv0f ( ) 方 法 实现 功能 逻辑 ,核心 思路 就 是 先 创建 一 个 ContentValues 对 

象 ， 然 后 遍历 pairs 参 数列 表 ， 取 出 其 中 的 数据 并 填 入 ContentValues 中 ， 最 终 将 
ContentValues 对 象 返回 即 可 。 思 路 并 不 复杂 ,但 是 存在 一 个 问题 : Pair 参 数 的 值 是 Any? 类 
型 的 ， 我们 怎样 让 它 和 ContentValues 所 支持 的 数据 类 型 对 应 起 来 呢 ? 这 个 确实 没有 什么 好 的 
办 法 ， 只 能 使 用 when 语 句 一 一 进行 条 件 判 断 ， 并 和 攻 盖 ContentValues 所 支持 的 所 有 数据 类 
型 。 结 合 下 面 的 代码 来 理解 应 该 更 加 清楚 一 些 : 


fun cvof(vararg pairs: Pair<String, Any?>): ContentValues { 
val cv = ContentValues() 
for (pair in pairs) { 
val key = pair.first 
val value = pair.second 
when (value) { 
is Int -> cv.put(key, value) 
is Long -> cv.put(key, value) 
is Short -> cv.put(key, value) 
is Float -> cv.put(key, value) 
is Double -> cv.put(key, value) 
is Boolean -> cv.put(key, value) 
is String -> cv.put(key, value) 
is Byte -> cv.put(key, value) 
is ByteArray -> cv.put(key, value) 
null -> cv.putNull (key) 
} 


return cyv 


} 


可 以 看 到 ， 上 述 代 码 基 本 就 是 按照 刚才 所 说 的 思路 进行 实现 的 。 我 们 使 用 for- in 循环 遍历 了 
pairs 参 数列 表 ,在 循环 中 取出 了 key 和 vaLue， 并 使 用 when 语 句 来 判断 vaLue 的 类 型 。 注 

意 , 这 里 将 ContentVaLues 所 支持 的 所 有 数据 类 型 全 部 覆盖 了 进去 ， 然 后 将 参数 中 传 入 的 键 值 
对 逐个 添加 到 ContentVaLues 中 ， 最 终 将 ContentVaLues 返 回 。 


另外 ,这 里 还 使 用 了 Kotlin 中 的 Smart Cast 功 能 。 比 如 when 语 名 进入 Int 条 件 分 支 后 ， 这 个 条 
件 下 面 的 vaLue 会 被 自动 转换 成 Int 类 型 ， 而 不 再 是 Any? 类 型 ， 这 样 我 们 就 不 需要 像 java 中 那 
样 再 额外 进行 一 次 向 下 转型 了 ， 这 个 功能 在 if 语句 中 也 同样 适用 。 


有 了 这 个 cv0f() 方 法 之 后 ,我 们 使 用 ContentValues 时 就 会 变 得 更 加 简单 了 ， 比 如 向 数据 库 
中 插入 一 条 数据 就 可 以 这 样 写 : 


val values = CvOf("name" to "Game of Thrones", "author" to "George Martin", 
"pages" to 720, "price" to 20.85) 
db.insert("Book", null, values) 


怎么 样 ?现在 我 们 可 以 使 用 类 似 于 map0f( ) 消 数 的 语法 结构 来 构建 ContentValues 对 象 ， 有 
没有 觉得 很 神奇 ? 


当然 ， 虽然 cv0f ( ) 方 法 已 经 非常 好 用 了 ， 但 是 它 和 高 阶 函 数 却 一 点 关系 也 没有 。 因 为 CVOf () 
方法 接收 的 参数 是 Pair 类 型 的 可 变 参数 列表 ， 返回 值 是 ContentValues 对 象 ， 完 全 没有 用 到 | 
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函数 类 型 ， 这 和 高 阶 消 数 的 定义 不 符 。 

从 功能 性 方面 ，cv0f( ) 方 法 好 像 确 实用 不 到 高 阶 函数 的 知识 ， 但 是 从 代码 实现 方面 ， 却 可 以 结 
合 高 阶 函 数 来 进行 进一步 的 优化 。 比 如 借助 appLy 函 数 ，cv0f ( ) 方 法 的 实现 将 会 变 得 更 加 优 
雅 : 


fun cvof(vararg pairs: Pair<String, Any?>) = ContentValues().apply { 
for (pair in pairs) { 
val key = pair.first 
val value = pair.second 
when (value) { 
is Int -> put(key, value) 
is Long -> put(key, value) 
is Short -> put(key, value) 
is Float -> put(key, value) 
is Double -> put(key, value) 
is Boolean -> put(key, value) 
is String -> put(key, value) 
is Byte -> put(key, value) 
is ByteArray -> put(key, value) 
null -> putNull (key) 
} 
} 


} 


由 于 appLy 函 数 的 返回 值 就 是 它 的 调用 对 象 本 身 ， 因 此 这 里 我 们 可 以 使 用 单行 代码 函数 的 语法 
糖 ， 用 等 号 替代 返回 值 的 声明 。 另 外 , appLy 函 数 的 Lambda 表 达 式 中 会 自动 拥有 
ContentValues 的 上 下 文 ， 所 以 这 里 可 以 直接 调用 ContentValues 的 各 种 put 方 法 。 借 助 高 
阶 函 数 之 后 ， 你 有 没有 觉得 代码 变 得 更 加 优雅 一 些 了 呢 ? 


当然 ， 虽 然 我 们 编写 了 一 个 非常 好 用 的 cvOf ( ) 方 法 ， 但 是 或 许 你 已 经 猜 到 了 ，KTX 库 中 也 提供 
了 一 个 具有 同样 功能 的 contentValues0f() 方 法 ,用 法 如 下 所 示 : 


val values = contentValues0Of("name" to "Game of Thrones", "author" to "George Martin", 
"pages" to 720, "price" to 20.85) 
db.insert("Book", null, values) 


三 | 


平时 我 们 在 编写 代码 的 时 候 ， 直接 使 用 KTX 提 供 的 contentVaLues0Of ( ) 方 法 就 可 以 了 ， 但 是 
通过 本 小 节 的 学 习 ， 你 不 仅 掌握 了 它 的 用 法 ， 还 明白 了 它 的 源码 实现 ， 有 没有 觉得 收获 了 更 多 
呢 ? 
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7.7 小结 与 反 评 


经 过 这 一 章 漫 长 的 学 习 ， 我 们 终于 可 以 缓解 一 下 疲劳 ， 对 本 章 所 学 的 知识 进行 梳理 和 总 结 了 。 
本 章 主要 对 Android 常 用 的 数据 持久 化 方式 进行 了 详细 的 讲解 ,包括 文件 存储 、 
SharedPreferences 存 储 以 及 数据 库存 储 。 其 中 ,文件 存储 适用 于 存储 一 些 简 单 的 文本 数据 和 
二 进 制 | 数据 ,SharedPreferences 存 储 适用 于 存储 一 些 键 值 对 ， 而 数据 库存 储 则 适用 于 存储 那 
些 复杂 的 关系 型 数据 。 虽 然 目 前 你 已 经 掌握 了 这 3 种 数据 持久 化 方式 的 用 法 ， 但 是 如 何 根据 项 目 
的 实际 需求 选择 最 合适 的 方式 是 你 未 来 需要 继续 探索 的 。 


在 本 章 的 Kotlin 课 堂 中 ， 我们 并 没有 学 习 太 多 新 的 知识 ， 而 是 通过 两 节 实 践 课程 让 你 更 好 地 理解 
了 高 阶 函 数 的 使 用 场景 ， 以 及 如 何 借助 高 阶 函 数 和 其 他 一 些 技巧 对 现 有 的 API 进 行 扩 展 。 
正如 上 一 章 小 结 里 提 到 的 ， 既 然 现在 我 们 已 经 掌握 了 Android 中 的 数据 持久 化 技术 ， 接 下 来 就 应 


该 继续 学 习 Android 中 的 四 大 组 件 了 。 放 松 一 下 自己 ， 然 后 踏 上 ContentProvider 的 学 习 之 旅 
吧 。 
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第 8 章 ” 跨 程序 共享 数据 ,探究 


ContentProvider 


在 上 一 章 中 我 们 学 了 Android 数 据 持久 化 技术 ， 包 括 文件 存储 、SharedPreferences 存 储 以 及 
数据 库存 储 。 不 知道 你 有 没有 发 现 ， 使 用 这 些 持久 化 技术 所 保存 的 数据 只 能 在 当前 应 用 程序 中 
访问 。 虽 然 文 件 存储 和 SharedPreferences 存 储 中 提供 了 MODE _WORLD READABLE 和 
MODE_WORLD_WRITEABLE 这 两 种 操作 模式 ， 用 于 供给 其 他 应 用 程序 访问 当前 应 用 的 数据 , 但 
这 两 种 模式 在 Android 4.2 版 本 中 都 已 被 废弃 了 。 为 什么 呢 ? 因为 Android 官 方 已 经 不 再 推荐 使 
用 这 种 方式 来 实现 跨 程 序数 据 共 享 的 功能 ， 而 是 推荐 使 用 更 加 安全 可 靠 的 ContentProvider 技 
术 。 


能 你 会 有 些 疑 惑 ， 为 什么 要 将 我 们 程序 中 的 数据 共享 给 其 他 程序 呢 ? 当然 ， 这 个 是 要 视 情 况 
eh 比如 账号 和 密码 这 样 的 隐私 数据 显然 是 不 能 共享 给 其 他 程序 的 ， 不 过 一 些 可 以 让 其 他 
程序 进行 二 次 开发 的 数据 是 可 以 共享 的 。 例 如 系统 的 通讯 录 程 序 ， 它 的 数据 库 中 保存 了 很 多 联 
系 人 信息 ， 如 果 这 些 数据 都 不 允许 第 三 方程 序 进行 访问 的 话 ， 丽 折 很 多 应 用 的 功能 就 要 大 打折 
扣 了 。 除了 通讯 录 之 外 , 还 有 短信 、 媒 体 库 等 程序 都 实现 了 跨 程序 数据 共享 的 功能 ， 而 使 用 的 
技术 当然 就 是 ContentProvider 了 ， 下 面 我 们 就 对 这 一 技术 进行 深入 的 探讨 。 
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8.1 ContentProvider 人 简介 


ContentProvider 主 要 用 于 在 不 同 的 应 用 程序 之 间 实 现 数据 共享 的 功能 , 它 提 供 了 一 套 完整 的 
机 制 ， 人 允许 一 个 程序 访问 另 一 个 程序 中 的 数据 ， 同 时 还 能 保证 被 访问 数据 的 安全 性 。 目 前 ,使 
用 ContentProvider 是 Android 实 现 跨 程序 共享 数据 的 标准 方式 。 


不 同 于 文件 存储 和 SharedPreferences 存 储 中 的 两 种 全 局 可 读 写 操作 模式 ，ContentProvider 
可 以 选择 只 对 哪 一 部 分 数据 进行 共享 ， 从 而 保证 我 们 程序 中 的 隐私 数据 不 会 有 泄漏 的 风险 。 


不 过 ,在 正式 开始 学 习 ContentProvider 之 前 ， 我们 需要 先 掌握 另外 一 个 非常 重要 的 知识 一 一 
Android 运 行 时 权限 ， 因 为 待 会 的 ContentProvider 示 例 中 会 用 到 运行 时 权限 的 功能 。 当 然 ， 
不 光 是 ContentProvider ,以 后 我 们 的 开发 过 程 中 会 经 常 使 用 运行 时 权限 ， 因 此 你 必须 能 够 牢 
牢 掌 握 它 才 行 。 
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8.2 ”运行 时 权限 


Android 的 权限 机 制 并 不 是 什么 新 鲜 事物 ， 从 系统 的 第 一 个 版 本 开始 就 已 经 存在 了 。 但 其 实 之 前 
Android 的 权限 机 制 在 保护 用 户 安全 和 隐私 等 方面 起 到 的 作用 比较 有 限 ， 尤 其 是 一 些 大 家 都 离 不 
开 的 常用 软件 ,非常 容易 “ 店 大 欺 客 ”"。 为 此 ，Android 开 发 团队 在 Android 6.0 系 统 中 引入 了 运 
行 时 权限 这 个 功能 ， 从 而 更 好 地 保护 了 用 户 的 安全 和 隐私 ， 那 么 本 节 我 们 就 来 详细 学 习 一 下 这 
个 新 功能 。 


8.2.1 Android 权 限 机 制 详解 


首先 回顾 一 下 过 去 Android 的 权限 机 制 。 我 们 在 第 6 章 写 BroadcastTest 项 目的 时 候 第 一 次 接触 
了 Android 权 限 相 关 的 内 容 ， 当 时 为 了 要 监听 开机 广播 , 我 们 在 AndroidManifest.xm| 文 件 中 
添加 了 这 样 一 句 权 限 声明 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.broadcasttest"> 


<uses-permission android:name="android.permission.RECEIVE BOOT COMPLETED" /> 


</manifest> 


因为 监听 开机 广播 涉及 了 用 户 设备 的 安全 ， 因 此 必须 在 AndroidManifest.xml 中 加 入 权限 声 
明 ,否则 我 们 的 程序 就 会 月 演 。 


那么 现在 问题 来 了 ， 加 入 了 这 名 权限 声明 后 ， 对 于 用 户 来 说 到 底 有 什么 影响 呢 ? 为 什么 这 样 就 
可 以 保护 用 户 设备 的 安全 了 呢 ? 


其 实用 户主 要 在 两 个 方面 得 到 了 保护 。 一 方面 ， 如果 用 户 在 低 于 Android 6.0 系 统 的 设备 上 安装 
该 程序 ， 会 在 安装 界面 给 出 如 图 8.1 所 示 的 提醒 。 这 样 用 户 就 可 以 清楚 地 知晓 该 程序 一 共 申请 了 
哪些 权限 ， 从 而 决定 是 否 要 安装 这 个 程序 。 
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园 BroadcastTest 
要 安装 此 应 用 吗 ? 它 将 获得 以 下 权限 : 
设备 相关 权限 


次 | 开机 启动 


取消 安装 


图 8.1 安装 界面 的 权限 提醒 


男 一 方面 ， 用户 可 以 随时 在 应 用 程序 管理 界面 查看 任意 一 个 程序 的 权限 申请 情况 ， 如 图 8.2 所 
示 。 这 样 该 程序 申请 的 所 有 权限 就 尽 收 眼底 ， 什 么 都 瞒 不 过 用 户 的 眼睛 ， 以 此 保证 应 用 程序 不 


会 出 现 各 种 滥用 权限 的 情况 。 
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应 用 信息 


缓存 0.00B 


默认 操作 


图 8.2 管理 界面 的 权限 展示 


这 种 权限 机 制 的 设计 思路 其 实 非 常 简 单 ， 就 是 用 户 如 果 认 可 你 所 申请 的 权限 ， 就 会 安装 你 的 程 
序 ,如果 不 认 可 你 所 申请 的 权限 ， 那 么 拒绝 安装 就 可 以 了 。 


但 是 理想 是 美好 的 ， 现 实 却 很 残酷 。 很 多 我 们 离 不 开 的 常用 软件 普遍 存在 着 滥用 权限 的 情况 ， 
不 管 到 底 用 不 用 得 到 ， 反正 先 把 权限 申请 了 再 说 。 比 如 微 信 所 申请 的 权限 列表 如 图 8.3 所 示 。 
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划 面 23:33 


Q 


图 8.3 ” 微 信 的 权限 列表 


这 还 只 是 微 信 所 申请 的 一 半 左 右 的 权限 ， 因 为 权限 太 多 ， 一 屏 截 不 全 。 其 中 有 一 些 权 限 我 并 不 
认可 ， 比 如 微 信 为 什么 要 读 取 我 手机 的 短信 和 彩信 ? 但 是 不 认可 又 能 怎样 ， 难 道 我 拒绝 安装 微 
信 ? 没 错 ， 这 种 例子 比比 缘 是 ， 一 些 软件 在 让 用 户 产生 依赖 以 后 就 会 容易 “ 店 大 欺 客 ”, 反正 这 
个 权限 我 就 是 要 了 ， 你 自己 看 着 办 吧 ! 


Android 开 发 团队 当然 也 意识 到 了 这 个 问题 ， 于 是 在 Android 6.0 系 统 中 加 入 了 运行 时 权限 功 
能 。 也 就 是 说 ， 用 户 不 需要 在 安装 软件 的 时 候 一 次 性 授权 所 有 申请 的 权限 ， 而 是 可 以 在 软件 的 
使 用 过 程 中 再 对 某 一 项 权限 申请 进行 授权 。 比 如 一 款 相 机 应 用 在 运行 时 申请 了 地 理 位 置 定位 权 
限 ， 就 算 我 拒绝 了 这 个 权限 ， 也 应 该 可 以 使 用 这 个 应 用 的 其 他 功能 ， 而 不 是 像 之 前 那样 直接 无 
法 安装 它 。 


当然 ， 并 不 是 所 有 权限 都 需要 在 运行 时 申请 ， 对 于 用 户 来 说 ， 不 停 地 授权 也 很 烦琐 。Android 现 
在 将 常用 的 权限 大 致 归 成 了 两 类 ， 一 类 是 普通 权限 ， 一 类 是 危险 权限 。 准 确 地 讲 ， 其 实 还 有 一 
些 特殊 权限 ， 不 过 这 些 权 限 使 用 得 相对 较 少 ， 因 此 不 在 本 书 的 讨论 范围 之 内 。 普 通 权 限 指 的 是 
那些 不 会 直接 威胁 到 用 户 的 安全 和 隐私 的 权限 ， 对 于 这 部 分 权限 申请 ， 系 统 会 自动 帮 有 我 们 进行 
授权 ,不 需要 用 户 手 动 操作 ， 比 如 在 BroadcastTest 项 目 中 申请 的 权限 就 是 普通 权限 。 危 险 权 
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限 则 表示 那些 可 能 会 触及 用 户 隐私 或 者 对 设备 安全 性 造成 影响 的 权限 ， i nl 
息 、 定 位 设备 的 地 理 位 置 等 ， 对 于 这 部 分 权限 申请 ， 必 须 由 用 户 手 动 授权 才 可 以 ， 否 则 程序 就 
无 法 使 用 相应 的 功能 。 


但 是 Android 中 一 共有 上 百 种 权限 ， 我 们 怎么 从 中 区 分 哪些 是 普通 权限 ， 哪 些 是 危险 权限 呢 ?其 
0 那么 难 ， 因 为 危险 权限 总 共 就 那么 些 ， 除了 危险 权限 之 外 ， 剩 下 的 大 多 就 是 普通 权限 
。 表 8.1 列 出 了 到 Android 10 系 统 为 止 所 有 的 危险 权限 ， 一 共 是 11 组 30 个 权限 。 


表 8.1 到 Android 10 系 统 为 止 所 有 的 危险 权限 


权限 组 名 权限 名 


READ_CALENDAR 


CALENDAR WRITE_CALENDAR 


READ CALL L0G 
CALL L0G WRITE CALL L0G 
PROCESS OUTGOING CALLS 


CAMERA CAMERA 


READ CONTACTS 
CONTACTS WRITE CONTACTS 
GET_ACCOUNTS 


ACCESS FINE LOCATION 
LOCATION ACCESS COARSE LOCATION 
ACCESS BACKGROUND LOCATION 


MICROPHONE RECORD AUDIO 


READ_PHONE_STATE 
READ PHONE NUMBERS 
CALL_ PHONE 

PHONE ANSWER_PHONE_CALLS 
ADD_VOICEMAIL 
USE SIP 
ACCEPT_HANDOVER 


SENSORS BODY_SENSORS 
ACTIVITY RECOGNITION ACTIVITY RECOGNITION 
SEND_SMS 
RECEIVE SMS 
SMS READ_SMS 


RECEIVE WAP_PUSH 
RECEIVE MMS 


READ EXTERNAL STORAGE 
STORAGE WRITE EXTERNAL STORAGE 
ACCESS MEDIA LOCATION 
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这 张 表格 你 看 起 来 可 能 并 不 会 那么 轻松 ， 因 为 里 面 的 权限 全 都 是 你 没 使 用 过 的 。 不 过 没有 关 
系 ， 你 并 不 需要 了 解 表格 中 每 个 权限 的 作用 ， 只 要 把 它 当 成 一 个 参照 表 来 查看 就 行 了 。 每 当 要 
使 用 一 个 权限 时 ， 可 以 先 到 这 张 表 中 查 一 下 ， 如 果 是 这 张 表 中 的 权限 ， 就 需要 进行 运行 时 权限 
处 理 ， 否则 ,只 需要 在 AndroidManifest.xm | 文件 中 添加 一 下 权限 声明 就 可 以 了 。 


另外 注意 ， 表 格 中 每 个 危险 权限 都 属于 一 个 权限 组 ， 我 们 在 进行 运行 时 权限 处 理 时 使 用 的 是 权 
限 名 。 原 则 上 ， 用户 一 旦 同意 了 某 个 权限 申请 之 后 ， 同 组 的 其 他 权限 也 会 被 系统 自动 授权 。 但 
是 请 谨 记 ,不 要 基于 此 规则 来 实现 任何 功能 逻辑 ， 因 为 Android 系 统 随 时 有 可 能 调整 权限 的 分 
组 。 


好 了 ,关于 Android 权 限 机 制 的 内 容 就 讲 这 么 多 ， 理 论 知识 你 已 经 了 解 得 非常 充分 了 。 接 下 来 我 
们 就 学 习 一 下 如 何在 程序 运行 的 时 候 申 请 权限 。 


8.2.2 在 程序 运行 时 申请 权限 


首先 新 建 一 个 RuntimePermissionTest 项 目 ， 我 们 就 在 这 个 项 目的 基础 上 学 习 运 行 时 权限 的 使 
用 方法 。 在 开始 动手 之 前 ， 你 需要 考虑 一 下 到 底 要 申请 什么 权限 ， 其 实 表 8.1 中 列 出 的 所 有 权限 
都 是 可 以 申请 的 ,这 里 简单 起 见 ， 我 们 就 使 用 CALL_PHONE 这 个 权限 来 作为 本 小 节 的 示例 吧 。 


CALL_PHONE 这 个 权限 是 编写 拨打 电话 功能 的 时 候 需要 声明 的 ， 因 为 拨打 电话 会 涉及 用 户 手 机 
的 资费 问题 ， 因 而 被 列 为 了 危险 权限 。 在 Android 6.0 系 统 出 现 之 前 ， 拨 打 电 话 功能 的 实现 其 实 
非常 简单 ， 修 改 activity_main.xml 布 局 文件 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/makeCall" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Make Call" /> 


</LinearLayout> 


我 们 在 布局 文件 中 只 是 定义 了 一 个 按钮 ， 点 击 按钮 就 去 触发 拨打 电话 的 逻辑 。 接 着 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
makeCall.setOnClickListener { 
try { 
val intent = Intent(Intent.ACTION CALL) 
intent.data = Uri.parse("tel:10086") 
startActivity(intent) 
} catch (e: SecurityException) { 
e.printStackTrace() 
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} 


可 以 看 到 ， 在 按钮 的 点 击 事件 中 ， 我们 构建 了 一 个 隐 式 Intent ,Intent 的 action 指 定 为 
a ACTION_CALL , 这 是 一 个 系统 内 置 的 打 电 话 的 动作 ， 然 后 在 data 部 分 指定 了 协议 是 
el , 号 码 是 10086。 其 实 这 部 分 代码 我 们 在 3.3. 3 小 节 中 就 已 径 见 过 了 ,只 不 过 当时 指定 的 

ee ACTION_DIAL , 表示 打开 拨号 界面 ， 这 个 是 不 需要 声明 权限 的 ， 而 
Intent .ACTION_CALL 则 表示 直接 拨打 电话 ， 因 此 必须 声明 权限 。 另 外 ， 为 了 防止 程序 衣 溃 ， 
我 们 将 所 有 操作 都 放 在 了 异常 捕获 代码 块 当中 。 


接 下 来 修改 AndroidManifest.xml 文 件 ， 在 其 中 声明 如 下 权限 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.runtimepermissiontest"> 


<uses-permission android:name="android.permission.CALL PHONE" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


</manifest> 


这 样 我 们 就 将 拨打 电话 的 功能 成 功 实现 了 ， 并 且 在 低 于 Android 6.0 系 统 的 手机 上 都 是 可 以 正常 
运行 的 。 但 是 , 如 果 我 们 在 Android 6.0 或 者 更 高 版 本 系统 的 手机 上 运行 ,点击 “Make Call" 按 
钮 就 没有 任何 效果 了 ， 这 时 观察 Logcat 中 的 打印 日 志 ， 你 会 看 到 如 图 8.4 所 示 的 错误 信息 。 


java.Lang.SecurityException: Permission Denial: starting Intent { act=android,intent.action.CALL 
at android,.os.Parcel.createException(Parcel. java:2069) 
at android,os,ParceL, readException(ParceL,java:2037) 
at android.os.ParceL, readException(ParceL,java:1986) 
at android,app,IActivityTaskManager$Stub$Proxy, startActivity(IActivityTaskManager,java:3827) 
at android.app.Instrumentation.execStartActivity(Instrumentation. java:1705) 
at android,.app.Activity,.startActivityForResult(Activity,.java:5173) 
at androidx.fragment.app.FragmentActivity,.startActivityForResult (FragmentActivity,.java:767) 
at android,app,Activity.startActivityForResutLt(Activity,java:5131) 
at androidx,fragment,app,FragmentActivity,startActivityForResuLt(FragmentActivity,java:754) 
at android,.app.Activity.startActivity(Activity.java:5582) 
at android,.app,.Activity,.startActivity(Activity,java:5470) 
at com,examptLe, runtimepermissiontest,MainActivity$onCreate$1.onCLick(MainActivity,kt:19) 


图 8.4 ”错误 日 志 信息 


错误 信息 中 提醒 我 们 “Permission Denial”, 可 以 看 出 ， 这 是 由 于 权限 被 禁止 所 导致 的 ， 因 为 
Android 6.0 及 以 上 系统 在 使 用 危险 权限 时 必须 进行 运行 时 权限 处 理 。 


那么 下 面 我 们 就 来 尝试 修复 这 个 问题 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
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makeCall.setOnClickListener { 

if (ContextCompat.checkSelfPermission(this, 
Manifest.permission.CALL PHONE) != PackageManager.PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(this, 

array0f (Manifest.permission.CALL PHONE), 1) 

} else { 
call() 

} 


} 


override fun onRequestPermissionsResult(requestCode: Int, 
permissions: Array<String>, grantResults: IntArray) { 
super.onRequestPermissionsResult(requestCode, permissions, grantResults) 
when (requestCode) { 
1 ->{ 
if (grantResults.isNotEmpty() && 
grantResults[0] == PackageManager.PERMISSION GRANTED) { 
call() 
} else { 
Toast.makeText(this, "You denied the permission", 
Toast.LENGTH SHORT).show() 


} 


private fun call() { 
try { 
val intent = Intent(Intent.ACTION CALL) 
intent.data = Uri.parse("tel:10086") 
startActivity(intent) 
} catch (e: SecurityException) { 
e.printStackTrace() 


} 


上 面 的 代码 覆盖 了 运行 时 权限 的 完整 流程 ， 下 面 我 们 具体 解析 一 下 。 说 白 了 ， 运 行 时 权限 的 核 
心 就 是 在 程序 运行 过 程 中 由 用 户 授权 我 们 去 执行 某 些 危险 操作 ,程序 是 不 可 以 擅自 做 主 去 执行 
这 些 危 险 操作 的 。 因 此 ， 第 一 步 就 是 要 先 判 断 用 户 是 不 是 已 经 给 过 我 们 授权 了 ， 借 助 的 是 
ContextCompat.checkSelfPermission() 方 法 。checkSelfPermission() 方 法 接收 两 
个 参数 : 第 一 个 参数 是 Context ,这 个 没什么 好 说 的 ; 第 二 个 参数 是 具体 的 权限 名 ， 比 如 打 电 
话 的 权限 名 就 是 Manifest .permission.CALL PHONE。 然 后 我 们 使 用 方法 的 返回 值 和 
PackageManager .PERMISSION_GRANTED 做 比较 ， 相等 就 说 明 用 户 已 经 授权 ， 不 等 就 表示 用 
户 没 有 授权 。 


如 果 已 经 授权 的 话 就 简单 了 ， 直接 执行 拨打 电话 的 逻辑 操作 就 可 以 了 ， 这 里 我 们 把 拨打 电话 的 
逻辑 封装 到 了 call () 方 法 当中 。 如 果 没 有 授权 的 话 ， 则 需要 调用 
ActivityCompat.requestPermissions() 方 法 向 用 户 申 请 授权 。 
requestPermissions() 方 法 接收 3 个 参数 : 第 一 个 参数 要 求 是 Activity 的 实例 ; 第 二 个 参数 
是 一 个 String 数 组 ,我 们 把 要 申请 的 权限 名 放 在 数组 中 即 可 ; 第 三 个 参数 是 请 求 码 ， 只 要 是 唯 
一 值 就 可 以 了 ， 这 里 传 入 了 1。 
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调用 完 requestPermissions () 方 法 之 后 ,系统 会 弹出 一 个 权限 申请 的 对 话 框 ,用户 可 以 选 
择 同意 或 拒绝 我 们 的 权限 申请 。 不 论 是 哪 种 结果 ,最终 都 会 回调 到 
onRequestPermissionsResult() 方 法 中 ,而 授权 的 结果 则 会 封装 在 grantResults 参 数 
当中 。 这 里 我 们 只 需要 判断 一 下 最 后 的 授权 结果 : 如 果 用 户 同意 的 话 ， 就 调用 call ( ) 方 法 拨打 
电话 ; 如 果 用 户 拒绝 的 话 ， 我们 只 能 放弃 操作 ， 并且 弹出 一 条 失败 提示 。 


现在 重新 运行 一 下 程序 ,并 点 击 “Make Call" 按 钮 ,效果 如 图 8.5 所 示 。 


\ 


Allow RuntimePermissionTest to 
make and manage phone calls? 


图 8.5 申请 电话 权限 对 话 框 


由 于 用 户 还 没有 授权 过 我 们 拨打 电话 权限 ， 因 此 第 一 次 运行 会 弹出 这 样 一 个 权限 申请 的 对 话 
框 , 用户 可 以 选择 同意 或 者 拒绝 ,比如 说 这 里 点 击 了 “Deny”， 结果 如 图 8.6 所 示 。 
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RuntimePermissionTest 


MAKE CALL 


You denied the permission 


图 8.6 用户 拒 绝 了 权限 申请 


由 于 用 户 没有 同意 授权 ,我们 只 能 弹出 一 个 操作 失败 的 提示 。 下 面 我 们 再 次 点 击 “Make Call” 按 
钮 ,仍然 会 弹出 权限 申请 的 对 话 框 ,这 次 点 击 "Allow”, 结果 如 图 8.7 所 示 。 
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Calling.., 

10086 
:* #* © 
Mute Keypad Speaker 


图 8.7 ”拨打 电话 界面 


可 以 看 到 ， 这 次 我 们 就 成 功 进入 拨打 电话 界面 了 。 并 且 由 于 用 户 已 经 完成 了 授权 操作 ,之 后 再 
点 击 “Make Call" 按 钮 不 会 再 次 弹出 权限 申请 对 话 框 , 而 是 可 以 直接 拨打 电话 。 那 可 能 你 会 担 
心 , 万 一 以 后 我 又 后 悔 了 怎么 办 ?没有 关系 ， 用 户 随 时 都 可 以 将 授予 程序 的 危险 权限 进行 关 


闭 ,进入 Settings 一 Apps & notifications 一 RuntimePermissionTest 一 Permissions ， 


界面 如 图 8.8 所 示 。 
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€ Apppermissions Q 


oy 


RuntimePermissionTest 


ALLOWED 


Re Phone 


DENIED 


No permissions denied 


图 8.8 ”应 用 程序 权限 管理 界面 
在 这 里 我 们 可 以 通过 点 击 相应 的 权限 来 对 授权 过 的 危险 权限 进行 关闭 。 


好 了 ， 关 于 运行 时 权限 的 内 容 就 讲 到 这 里 ， 现 在 你 已 经 有 能 力 处 理 Android 上 各 种 关于 权限 的 问 
题 了 ,下 面 我 们 就 来 进入 本 章 的 正题 一 一 ContentProvider。 
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8.3 访问 其 他 程序 中 的 数据 


ContentProvider 的 用 法 一 般 有 两 种 : 一 种 是 使 用 现 有 的 ContentProvider 读 取 和 操作 相应 程 
序 中 的 数据 ; 另 一 种 是 创建 自己 的 ContentProvider , 给 程序 的 数据 提供 外 部 访问 接口 。 那 么 
接 下 来 我 们 就 一 个 一 个 开始 学 习 吧 ,首先 从 使 用 现 有 的 ContentProvider 开 始 。 


如 果 一 个 应 用 程序 通过 ContentProvider 对 其 数据 提供 了 外 部 访问 接口 ， 那么 任何 其 他 的 应 用 
程序 都 可 以 对 这 部 分 数据 进行 访问 。Android 系 统 中 自 带 的 通讯 录 、 短 信 、 媒 体 库 等 程序 都 提供 
了 类 似 的 访问 接口 ， 这 就 使 得 第 三 方 应 用 程序 可 以 充分 地 利用 这 部 分 数据 实现 更 好 的 功能 。 

面 我 们 就 来 看 一 看 ContentProvider 到 底 是 如 何 使 用 的 。 


8.3.1 ContentResolver 的 基本 用 法 


对 于 每 一 个 应 用 程序 来 说 ， 如 果 想 要 访问 ContentProvider 中 共享 的 数据 ， 就 一 定 要 借助 
ContentResolver 类 ， 可 以 通过 Context 中 的 getContentResolver() 方 法 获取 该 类 的 实 
例 。ContentResolver 中 提供 了 一 系列 的 方法 用 于 对 数据 进行 增删 改 查 操作 , 其 中 ijnsert() 
方法 用 于 添加 数据 ，update( ) 方 法 用 于 更 新 数据 , delete( ) 方 法 用 于 删除 数据 ，query ( ) 方 
法 用 于 查询 数据 。 有 没有 似曾相识 的 感觉 ? 没 错 ，SQLiteDatabase 中 也 是 使 用 这 几 个 方法 进 
行 增删 改 查 操作 的 ， 只 不 过 它们 在 方法 参数 上 稍微 有 一 些 区 别 。 


不 同 于 SQLiteDatabase ,ContentResolver 中 的 增删 改 查 方法 都 是 不 接收 表 名 参数 的 ， 而 是 
使 用 一 个 Uri 参 数 代替 ， 这 个 参数 被 称 为 内 容 URI。 内 容 URI 给 ContentProvider 中 的 数据 建立 
了 唯一 标识 符 ， 它 主要 由 两 部 分 组 成 : authority 和 path。authority 是 用 于 对 不 同 的 应 用 程序 
做 区 分 的 ， 一 般 为 了 避免 冲突 ， 会 采用 应 用 包 名 的 方式 进行 命名 。 比 如 某 个 应 用 的 包 名 是 
com.example.app， 那 么 该 应 用 对 应 的 authority 就 可 以 命名 为 
com.example.app.provider。path 则 是 用 于 对 同一 应 用 程序 中 不 同 的 表 做 区 分 的 ， 通 常会 添 
加 到 authority 的 后 面 。 比 如 某 个 应 用 的 数据 库 里 存在 两 张 表 table1 和 table2 ,这 时 就 可 以 将 
path 分 别 命名 为 /table1 和 /table2， 然 后 把 authority 和 path 进 行 组 合 ， 内容 URI 就 变 成 了 
com.example.app.provider/tablel 和 com.example.app.provider/table2。 不 过 ，, 目前 还 
很 难 辨认 出 这 两 个 字符 串 就 是 两 个 内 容 URI , 我们 还 需要 在 字符 串 的 头 部 加 上 协议 声明 。 因 此 ， 
内 容 URI 最 标准 的 格式 如 下 : 


content://com.example.app.provider/tablel 


content://com.example.app.provider/table2 


有 没有 发 现 ， 内容 URI 可 以 非常 清楚 地 表达 我 们 想 要 访问 哪个 程序 中 哪 张 表 里 的 数据 。 也 正 是 因 
此 ,ContentResolver 中 的 增删 改 查 方法 才 都 接收 Uri 对 象 作为 参数 。 如 果 使 用 表 名 的 话 ， 系 
统 将 无 法 得 知 我 们 期 望 访 问 的 是 哪个 应 用 程序 里 的 表 。 


在 得 到 了 内 容 URI 字 符 串 之 后 ， 我 们 还 需要 将 它 解析 成 Uri 对 象 才 可 以 作为 参数 传 入 。 解 析 的 方 
法 也 相当 简单 ， 代 码 如 下 所 示 : 


val uri = Uri.parse("content://com.example.app.provider/tablel") 


只 需要 调用 Uri.parse() 方 法 ,就 可 以 将 内 容 URI 字 符 串 解析 成 Uri 对 象 了 。 
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现在 我 们 就 可 以 使 用 这 个 Uri 对 象 查询 table1 表 中 的 数据 了 ， 代 码 如 下 所 示 : 


val cursor = contentResolver.query( 
uri, 
projection, 
selection, 
selectionArgs, 
sortOrder) 


这 些 参数 和 SQLiteDatabase 中 query () 方 法 里 的 参数 很 像 ， 但 总 体 来 说 要 简单 一 些 ， 毕竟 这 
是 在 访问 其 他 程序 中 的 数据 ， 没 必要 构建 过 于 复杂 的 查询 语句 。 表 8.2 对 使 用 到 的 这 部 分 参数 进 
行 了 详细 的 解释 。 


表 8.2 query() 方 法 的 参数 说 明 


query() 方 法 参数 对 应 SQL 部 分 描述 
ur from table_name 指定 查询 某 个 应 用 程序 下 的 某 一 张 表 
projection select columnl, column2 上 定 查询 的 列 名 
selection where column = value 指定 where 的 约束 条 件 
selectionArgs - 为 whnere 中 的 占 位 符 提供 具体 的 值 
sortorder order by cotumn1，cotumn2 指定 查询 结果 的 排序 方式 
查询 完成 后 返回 的 仍然 是 一 个 Cursor 对 象 ， 这 时 我 们 就 可 以 将 数据 从 Cursor 对 象 中 逐个 读 取 


出 来 了 。 读 取 的 思路 仍然 是 通过 移动 游标 的 位 车 遍历 Cursor 的 所 有 行 ， 然 后 取出 每 一 行 中 相应 
列 的 数据 ， 代 码 如 下 所 示 : 


while (cursor.moveToNext()) { 
val columnl = cursor.getString(cursor.getColumnIndex("column1")) 
val column2 = cursor.getInt(cursor.getColumnIndex("column2")) 


} 


cursor.close() 


掌握 了 最 难 的 查询 操作 ， 剩 下 的 增加 、 修 改 、 删 除 操作 就 更 不 在 话 下 了 。 我 们 先 来 看 看 如 何 向 
table1 表 中 添加 一 条 数据 ， 代 码 如 下 所 示 : 


val values = contentValues0f("columnl" to "text", "column2" to 1) 
contentResolver.insert(uri, values) 


可 以 看 到 ， 仍 然 是 将 待 添加 的 数据 组 装 到 ContentVaLues 中 ,然后 调用 ContentResolver 的 
insert() 方 法 ,将 Uri 和 ContentVaLues 作 为 参数 传 入 即 可 。 
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如 果 我 们 想 要 更 新 这 条 新 添加 的 数据 , 把 coLumn1 的 值 清空 ， 可 以 借助 ContentResolver 的 
update( ) 方 法 实现 ， 代 码 如 下 所 示 : 


val values = contentValues0f("columnl" to "") 
contentResolver.update(uri, values, "columnl = ? and column2 = ?", array0f("text", "1")) 


注意 ,上述 代码 使 用 了 selection 和 selectionArgs 参 数 来 对 想 要 更 新 的 数据 进行 约束 ， 以 
防止 所 有 的 行 都 会 受 影响 。 


最 后 , 可 以 调用 ContentResolver 的 delete() 方 法 将 这 条 数据 删除 掉 ， 代码 如 下 所 示 : 


contentResolver.delete(uri, "column2 = ?", array0f("1")) 


到 这 里 为 止 ， 我 们 就 把 ContentResolver 中 的 增删 改 查 方法 全 部 学 完了 。 是 不 是 感觉 一 看 就 
懂 ? 因为 这 些 知识 早 在 上 一 章 中 学 习 SQLiteDatabase 的 时 候 你 就 已 经 掌握 了 ， 所 需 特别 注意 
的 就 只 有 uri 这 个 参数 而 已 。 那 么 接 下 来 ， 我 们 就 利用 目前 所 学 的 知识 ， 看 一 看 如 何 读 取 系 统 通 
讯 录 中 的 联系 人 信息 。 

8.3.2 读 取 系统 联系 人 


由 于 我 们 一 直 都 是 使 用 模拟 器 来 学 习 的 ， 通 讯 录 里 面 并 没有 联系 人 存在 ， 所 以 现在 需要 自己 手 
动 添加 几 个 ， 以 便 稍 后 进行 读 取 。 打 开通 讯 录 程序 ， 界面 如 图 8.9 所 示 。 
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Create new contact 


让 Q 2 QD 
Favorites Recents Contacts Voicemail 
对 仿 机 


图 8.9 ”通讯 录 程 序 主 界面 


可 以 看 到 ,目前 通讯 录 里 没有 任何 联系 人 ，, 我们 可 以 通过 点 击 “Create new contact” 创 建 联系 
人 。 这 里 就 先 创建 两 个 联系 人 吧 ， 分 别 填 入 他 们 的 姓名 和 手机 号 ， 如 图 8.10 所 示 。 
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Create new contact Create new contact 


0 Saving to | Saving to 
Device Device 
2 Tom v 达 John v 
WW 1(234) 567-89| \。 (987) 654-321| 
wx xX 
Mobile Y Pager v 


图 8.10 ”创建 两 个 联系 人 
这 样 准备 工作 就 做 好 了 “， 现 在 新 建 一 个 ContactsTest 项 目 ， 让 我 们 开始 动手 吧 。 


首先 还 是 来 编写 一 下 布局 文件 ,这 里 我 们 希望 读 取 出 来 的 联系 人 信息 能 够 在 ListView 中 显示 ， 
因此 ,修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<ListView 
android:id="@+id/contactsView" 
android:layout width="match parent" 
android:layout height="match parent" > 
</ListView> 


</LinearLayout> 


简单 起 见 ，LinearLayout 里 只 放置 了 一 个 ListView。 这 里 之 所 以 使 用 ListView 而 不 是 
RecyclerView ,是 因为 我 们 要 将 关注 的 重点 放 在 读 取 系统 联系 人 上 面 ， 如 果 使 用 
RecyclerView 的 话 ， 代 码 偏 多 ， 会 容易 让 我 们 找 不 着 重点 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
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private val contactsList = ArrayList<String>() 
private lateinit var adapter: ArrayAdapter<String> 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
adapter = ArrayAdapter(this, android.R.layout.simple list item 1, contactsList) 
contactsView.adapter = adapter 
if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ CONTACTS) 
!= PackageManager .PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(this, 
array0f (Manifest.permission.READ CONTACTS), 1) 
} else { 
readContacts() 
} 


} 


override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, 
grantResults: IntArray) { 
super.onRequestPermissionsResult(requestCode, permissions, grantResults) 
when (requestCode) { 
1 -> { 
if (grantResults.isNotEmpty() 
AR& grantResults[0] == PackageManager.PERMISSION GRANTED) { 
readContacts() 
} else { 
Toast.makeText(this, "You denied the permission", 
Toast.LENGTH SHORT).show() 


} 


private fun readContacts() { 

// 查询 联系 人 数 和 

contentResolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_ URI, 
null, null, null, null)?.apply { 

while (moveToNext()) { 

// 获取 联系 人 姓名 
val displayName = getString(getColumnIndex( 
ContactsContract.CommonDataKinds.Phone.DISPLAY NAME)) 
// 获取 联系 人 手机 号 
val number = getString(getColumnIindex( 
ContactsContract .CommonDataKkinds .Phone.NUMBER) ) 
contactsList.add("$displayName\n$number") 


HU 


} 
adapter.notifyDataSetChanged () 
CLose() 


在 onCreate ( ) 方 法 中 ， 我 们 首先 按照 ListView 的 标准 用 法 对 其 初始 化 ， 然 后 开始 调用 运行 时 
权限 的 处 理 逻 辑 ,因为 READ_CONTACTS 权 限 属于 危险 权限 。 关 于 运行 时 权限 的 处 理 流程 ， 相 信 
你 已 经 熟练 掌握 了 ， 这 里 我 们 在 用 户 授权 之 后 ， 调用 readContacts ( ) 方 法 读 取 系统 联系 人 信 
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下 面 重点 看 一 下 readContacts () 方 法 ， 可 以 看 到 , 这 里 使 用 了 ContentResolver 的 
query ( ) 方 法 查询 系统 的 联系 人 数据 。 不 过 传 入 的 Uri 参 数 怎么 有 些 奇怪 啊 ? 为 什么 没有 调用 
Uri.parse() 方 法 去 解析 一 个 内 容 URI 字 符 串 呢 ? 这 是 因为 
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ContactsContract .CommonDataKkinds .Phone 类 已 经 帮 我 们 做 好 了 封装 ,提供 了 一 个 
CONTENT_URI 常 量 ， 而 这 个 常量 就 是 使 用 Uri ,parse( ) 方 法 解析 出 来 的 结果 。 接 着 我 们 对 
query() 方 法 返回 的 Cursor 对 象 进行 遍历 ， 这 里 使 用 了 ? .操作 符 和 appLy 函 数 来 简化 遍历 的 
代码 。 在 appLy 上 函数 中 将 联系 人 姓名 和 手机 号 乏 个 取出 ， 联 系 人 姓名 这 一 列 对 应 的 常量 是 
ContactsContract.CommonDataKinds.Phone.DISPLAY NAME ,联系 人 手机 号 这 一 列 对 
应 的 常量 是 ContactsContract ,CommonDatakinds,.Phone,NUMBER。 将 两 个 数据 取出 后 
进行 拼接 ， 并 且 在 中 间 加 上 换行 符 ， 然 后 将 拼接 后 的 数据 添加 到 ListView 的 数据 源 里 ， 并 通知 
刷新 一 下 ListView , 最 后 干 万 不 要 忘记 将 Cursor 对 象 关闭 。 


这 样 就 结束 了 吗 ? 还 差 一 点 点 ， 读 取 系 统 联 系 人 的 权限 干 万 不 能 忘记 声明 。 修 改 
AndroidManifest.xml 中 的 代码 ,如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.contactstest"> 


<uses-permission android:name="android,.permission.READ CONTACTS" /> 


</manifest> 


加 入 了 android.permission.READ CONTACTS 权 限 ， 这样 我 们 的 程序 就 可 以 访问 系统 的 联 
系 人 数据 了 。 现 在 终于 大 功 告 成 ， 让 我 们 来 运行 一 下 程序 吧 ， 效果 如 图 8.11 所 示 。 
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Allow ContactsTest to access 
your contacts? 


图 8.11 申请 访问 联系 人 权限 对 话 框 
首先 弹出 了 申请 访问 联系 人 权限 的 对 话 框 ,我们 点 击 “Allow”， 结果 如 图 8.12 所 示 。 
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10:54 4 | 
ContactsTest 


John 
(987) 654-321 


Tom 
1 (234) 567-89 


图 8.12 展示 系统 联系 人 信息 


刚刚 创建 的 两 个 联系 人 的 数据 都 成 功 读 取 出 来 了 ! 这 说 明 跨 程序 访问 数据 的 功能 确实 成 功 实现 
了 。 
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8.4 创建 自己 的 ContentProvider 


上 一 节 我 们 学 习 了 如 何在 自己 的 程序 中 访问 其 他 应 用 程序 的 数据 。 总 体 来 说 ， 思路 还 是 非常 简 
单 的 ， 只 需要 获得 该 应 用 程序 的 内 容 URI， 然 后 借助 ContentResolver 进 行 增删 改 查 操作 就 可 
以 了 。 可 是 你 有 没有 想 过 ， 那 些 提供 外 部 访问 接口 的 应 用 程序 都 是 如 何 实现 这 种 功能 的 呢 ? 它 
们 又 是 怎样 保证 数据 的 安全 ， 使 得 隐私 数据 不 会 泄漏 出 去 ? 学 习 完 本 节 的 知识 后 ， 你 的 疑惑 将 
会 被 一 一 解 开 。 


8.4.1 创建 ContentProvider 的 步骤 
前 面 已 经 提 到 过 ， 如果 想 要 实现 跨 程序 共享 数据 的 功能 ， 可 以 通过 新 建 一 个 类 去 继承 


ContentProvider 的 方式 来 实现 。ContentProvider 类 中 有 6 个 抽象 方法 ， 我 们 在 使 用 子 类 继承 
它 的 时 候 ， 需 要 将 这 6 个 方法 全 部 重 写 。 观 察 下 面 的 代码 示例 : 


class MyProvider : ContentProvider() { 


override fun onCreate(): Boolean { 
return false 
} 


override fun query(uri: Uri, projection: Array<String>?, selection: String?, 
selectionArgs: Array<String>?, sortOrder: String?): Cursor? { 
return null 


} 


override fun insert(uri: Uri, values: ContentValues?): Uri? { 
return null 
} 


override fun update(uri: Uri, values: ContentValues?, selection: String?, 
selectionArgs: Array<String>?): Int { 
return 0 


} 


override fun delete(uri: Uri, selection: String?, selectionArgs: Array<String>?): Int { 
return 0 
} 


override fun getType(uri: Uri): String? { 
return null 
} 


} 
对 于 这 6 个 方法 ， 相信 大 多 数 你 已 经 非常 熟悉 了 ， 我 再 来 简单 介绍 一 下 吧 。 


(1) onCreate()。 初 始 化 ContentProvider 的 时 候 调 用 。 通 常会 在 这 里 完成 对 数据 库 的 创建 和 
升级 等 操作 ， 返回 true 表 示 ContentProvider 初 始 化 成 功 ， 返 回 false 则 表示 失败 。 


(2) query()。 从 ContentProvider 中 查询 数据 。uri 参 数 用 于 确定 查询 哪 张 表 ， projection 
参数 用 于 确定 查询 哪些 列 ，selection 和 selectionArgs 参 数 用 于 约束 查询 哪些 行 ， 
sort0rder 参 数 用 于 对 结果 进行 排序 ， 查 询 的 结果 存放 在 Cursor 对 象 中 返回 。 
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(3) insert()。 向 ContentProvider 中 添加 一 条 数据 。uri 参 数 用 于 确定 要 添加 到 的 表 ， 待 添 
加 的 数据 保存 在 vatues 参 数 中 。 添 加 完成 后 ,返回 一 个 用 于 表示 这 条 新 记录 的 URI。 


(4) update( )。 更 新 ContentProvider 中 已 有 的 数据 。uri 参 数 用 于 确定 更 新 哪 一 张 表 中 的 数 
据 ,新 数据 保存 在 vaLueSs 参 数 中 , seLection 和 setLectionArgs 参 数 用 于 约束 更 新 哪些 行 ， 
受 影响 的 行 数 将 作为 返回 值 返回 。 


(5) delete()。 从 ContentProvider 中 删除 数据 。uri 参 数 用 于 确定 删除 哪 一 张 表 中 的 数据 ， 
selection 和 selectionArgs 参 数 用 于 约束 删除 哪些 行 ， 被 删除 的 行 数 将 作为 返回 值 返 回 。 


(6) getType ( ) 。 根 据 传 入 的 内 容 URI 返 回 相 应 的 MIME 类 型 。 

可 以 看 到 ， 很 多 方法 里 带 有 uri 这 个 参数 ， 这 个 参数 也 正 是 调用 ContentResolver 的 增删 改 查 
方法 时 传递 过 来 的 。 而 现在 我 们 需要 对 传 入 的 uri 参 数 进行 解析 ， 从 中 分 析出 调用 方 期 望 访问 的 
表 和 数据 。 

回顾 一 下 ， 一 个 标准 的 内 容 URI 写 法 是 : 

content://com.example.app.provider/tablel 

这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 table1 表 中 的 数据 。 

除 此 之 外 ， 我 们 还 可 以 在 这 个 内 容 URI 的 后 面 加 上 一 个 id ， 例 如 : 
content://com.example.app.provider/tablel/1 

这 就 表示 调用 方 期 望 访问 的 是 com.example.app 这 个 应 用 的 table1 表 中 id 为 1 的 数据 。 

内 容 URI 的 格式 主要 就 只 有 以 上 两 种 ， 以 路 径 结 尾 表示 期 望 访问 该 表 中 所 有 的 数据 ， 以 id 结尾 表 
示 期 望 访 问 该 表 中 拥有 相应 id 的 数据 。 我 们 可 以 使 用 通配符 分 别 匹 配 这 两 种 格式 的 内 容 URI , 规 
则 如 下 。 


。# 表 示 匹 配 任意 长 度 的 任意 字符 。 
。 # 表 示 匹 配 任意 长 度 的 数字 。 


所 以 ， 一 个 能 够 匹配 任意 表 的 内 容 URI 格 式 就 可 以 写成 : 


一 个 能 够 匹配 table1 表 中 任意 一 行 数据 的 内 容 URI 格 式 就 可 以 写成 : 


content://com.example.app.provider/tablel/# 


接着 ,我 们 再 借助 UriMatcher 这 个 类 就 可 以 轻松 地 实现 匹配 内 容 URI 的 功能 。UriMatcher 中 
提供 了 一 个 addURI () 方 法 ,这 个 方法 接收 3 个 参数 ， 可 以 分 别 把 authority、path 和 一 个 自 
定义 代码 传 进去 。 这 样 ， 当 调用 UriMatcher 的 match() 方 法 时 ，, 就 可 以 将 一 个 Uri 对 象 传 
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入 ,返回 值 是 某 个 能 够 匹配 这 个 Uri 对 象 所 对 应 的 自 定 义 代 码 ， 利 用 这 个 代码 ， 我 们 就 可 以 判断 
出 调用 方 期 望 访问 的 是 哪 张 表 中 的 数据 了 。 修 改 MyProvider 中 的 代码 , 如 下 所 示 : 

class MyProvider : ContentProvider() { 

private val tablelDir = 0 
private val tablelIltem = 1 
private val table2Dir = 2 
private val table2Item = 3 


private val uriMatcher = UriMatcher(UriMatcher.NO MATCH) 


init { 
uriMatcher.addURI("com.example.app.provider", "tablel", tablelDir) 
uriMatcher.addURI("com.example.app.provider ", "tablel/#", tablelItem) 
uriMatcher.addURI("com.example.app.provider ", "table2", table2Dir) 
uriMatcher.addURI("com.example.app.provider ", "table2/#", table2Item) 


} 


override fun query(uri: Uri, projection: Array<String>?, selection: String?, 
selectionArgs: Array<String>?, sortOrder: String?): Cursor? { 
when (uriMatcher.match(uri)) { 
tablelDir -> { 
// 查询 tabLe1 表 中 的 所 有 数 


HU 


} 
tablelItem -> { 
// 查询 tabLe1 表 中 的 单条 数据 


} 
table2Dir -> { 
// 查询 tabLe2 表 中 的 所 有 数 


HU 


} 
table2Item -> { 
// 查询 tabLe2 表 中 的 单条 数据 


} 


} 


可 以 看 到 ，MyProvider 中 新 增 了 4 个 整 型 变量 ,其 中 table1Dir 表 示 访 问 tablel 表 中 的 所 有 数 
据 , tabLe1Item 表 示 访 问 table1 表 中 的 单条 数据 ,tabLe2Dir 表 示 访 问 table2 表 中 的 所 有 数 
据 , tabLe2Item 表 示 访 问 table2 表 中 的 单条 数据 。 接 着 我 们 在 MyProvider 类 实例 化 的 时 候 
立刻 创建 了 UriMatcher 的 实例 ， 并 调用 addURI ( ) 方 法 , 将 期 望 匹配 的 内 容 URI 格 式 传递 进 
去 ， 注 意 这 里 传 入 的 路 径 参 数 是 可 以 使 用 通配符 的 。 然 后 当 que ry ( ) 方 法 被 调用 的 时 候 ， 就 会 
通过 UriMatcher 的 match() 方 法 对 传 入 的 Uri 对 象 进行 匹配 ,如 果 发 现 UriMatcher 中 某 个 
内 容 URI 格 式 成 功 匹 配 了 该 Uri 对 象 ， 则 会 返回 相应 的 自 定义 代码 ， 然 后 我 们 就 可 以 判断 出 调用 
方 期 望 访问 的 到 底 是 什么 数据 了 。 


上 述 代 码 只 是 以 query ( ) 方 法 为 例 做 了 个 示范 ， 其实 ijnsert()、update()、delete() 这 几 
个 方法 的 实现 是 差不多 的 ， 它 们 都 会 携带 uri 这 个 参数 ， 然 后 同样 利用 UriMatcher 的 
match() 方 法 判断 出 调用 方 期 望 访 问 的 是 哪 张 表 ， 再 对 该 表 中 的 数据 进行 相应 的 操作 就 可 以 
人 


除 此 之 外 ,还 有 一 个 方法 你 可 能 会 比较 陌生 , 即 getType () 方 法 。 它 是 所 有 的 
ContentProvider 都 必须 提供 的 一 个 方法 ， 用 于 获取 Uri 对 象 所 对 应 的 MIME 类 型 。 一 个 内 容 
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URI 所 对 应 的 MIME 字 符 串 主要 由 3 部 分 组 成 ,， Android 对 这 3 个 部 分 做 了 如 下 格式 规定 。 


。 必须 以 vnd 开 头 。 

。 如 果 内 容 URI 以 路 径 结尾 ， 则 后 接 android .cursor,dir/ ; 如 果 内 容 URI 以 id 结尾 , 则 后 
接 android,.cursor.item/。 

。 最 后 接 上 vnd .<authority>.<path>。 


所 以 ,对 于 content://com.example.app.provider/tablel 这 个 内 容 URI , 它 所 对 应 的 MIME 类 
型 就 可 以 写成 : 


vnd.android,.cursor.dir/vnd.com.example.app.provider.tablel 


对 于 content://com.example.app.provider/table1/1 这 个 内 容 URI , 它 所 对 应 的 MIME 类 型 就 
可 以 写成 : 


vnd.android.cursor.item/vnd.com.example.app.provider.tablel 


现在 我 们 可 以 继续 完善 MyProvider 中 的 内 容 了 , 这 次 来 实现 getType ( ) 方 法 中 的 逻辑 ,代码 
如 下 所 示 : 


class MyProvider : ContentProvider() { 


override fun getType(uri: Uri) = when (uriMatcher.match(uri)) { 
tablelDir -> "vnd.android.cursor.dir/vnd.com.example.app.provider.tablel" 
tablelIltem -> "vnd.android.cursor.item/vnd.com.example.app.provider.tablel" 
table2Dir -> "vnd.android.cursor.dir/vnd.com.example.app.provider.table2" 
table2Item -> "vnd.android.cursor.item/vnd.com.example.app.provider.table2" 
else -> null 

} 

} 


到 这 里 ， 一 个 完整 的 ContentProvider 就 创建 完成 了 ， 现 在 任何 一 个 应 用 程序 都 可 以 使 用 
ContentResolver 访 问 我 们 程序 中 的 数据 。 那 么 ， 如 何 才能 保证 隐私 数据 不 会 泄漏 出 去 呢 ? 其 
实 多 亏 了 ContentProvider 的 良好 机 制 ， 这 个 问题 在 不 知 不 觉 中 已 经 被 解决 了 。 因 为 所 有 的 增 
删改 查 操作 都 一 定 要 匹配 到 相应 的 内 容 URI 格 式 才 能 进行 ， 而 我 们 当然 不 可 能 向 UriMatcher 中 
添加 隐私 数据 的 URI , 所 以 这 部 分 数据 根本 无 法 被 外 部 程序 访问 ， 安 全 问题 也 就 不 存在 了 。 


好 了 “， 创 建 ContentProvider 的 步 又 你 已 经 清楚 了 ,下 面 就 来 实战 一 下 ,真正 体验 一 回 跨 程序 
数据 共享 的 功能 。 


8.4.2 ”实现 跨 程序 数据 共享 


简单 起 见 ， 我 们 还 是 在 上 一 章 中 DatabaseTest 项 目的 基础 上 继续 开发 ， 通 过 ContentProvider 
来 给 它 加 入 外 部 访问 接口 。 打 开 DatabaseTest 项 目 , 首先 将 MyDatabaseHelper 中 使 用 Toast 
弹出 创建 数据 库 成 功 的 提示 去 除 ， 因 为 跨 程 序 访问 时 我 们 不 能 直接 使 用 Toast。 然 后 创建 一 个 
ContentProvider , 右 击 com.example.databasetest 包 >-NewOtherContent 

Provider , 会 弹出 如 图 8.13 所 示 的 窗口 。 
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New Android Component 


Configure Component 


Android Studio 


Creates a new content provider component and adds it to your 
Android manifest. 


Class Name: DatabaseProvider 


URI Authorities: com.example.databasetest.provider 


Exported 
Enabled 


Source Language: Kotlin 了 


Cancel revious Nex 


图 8.13 创建 ContentProvider 的 窗口 


可 以 看 到 ,我们 将 ContentProvider 命 名 为 DatabaseProvider , 将 autho rity 指 定 为 
com.example.databasetest.provider ,Exported 属 性 表示 是 否 允 许 外 部 程序 访问 我 们 
的 ContentProvider , EnabLed 属 性 表示 是 人 否 启 用 这 个 ContentProvider。 将 两 个 属性 都 勾 
中 ,点 击 “Finish” 完 成 创建 。 


接着 我 们 修改 DatabaseProvider 中 的 代码 ,如 下 所 示 : 


class DatabaseProvider : ContentProvider() { 

bookDir = 0 

bookItem = 1 

categoryDir = 2 

categoryItem = 3 

authority = "com.example.databasetest.provider 
dbHelper: MyDatabaseHelper? = null 


val 
val 
val 
val 
val 
var 


private 
private 
private 
private 
private 
private 


private val uriMatcher by lazy { 
val matcher = UriMatcher(UriMatcher.NO MATCH) 


matcher.addURI (authority, 
matcher.addURI(authority, 
matcher.addURI (authority, 
matcher.addURI (authority, 


matcher 

} 

override fun onCreate() = 
dbHelper = MyDatabaseHelper(it, 
true 

} ?: false 


"book", bookDir) 

"book/#", bookItem) 
"category", categoryDir) 
"category/#", categoryItem) 


context?.let { 


"BookStore.db", 2) 
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override fun query(uri: Uri, projection: Array<String>?, selection: String?, 
selectionArgs: Array<String>?, sortOrder: String?) = dbHelper?.let { 
// 查询 数据 
val db = it.readableDatabase 
val cursor = when (uriMatcher.match(uri)) { 
bookDir -> db.query("Book", projection, selection, selectionArgs, 
null, null, sortOrder) 
bookItem -> { 
val bookId = uri.pathSegments[1] 
db.query("Book", projection, "id = ?", array0f(bookId), null, null, 
sortOrder) 


} 
categoryDir -> db.query("Category", projection, selection, selectionArgs, 
null, null, sortOrder) 
categoryItem -> { 
val categoryId = uri.pathSegments[1] 
db.query("Category", projection, "id = ?", array0f(categoryl1d), 
null, null, sortOrder) 


} 

else -> null 
} 
cursor 


} 


override fun insert(uri: Uri, values: ContentValues?) = dbHelper?.let { 
// 添加 数据 
val db = it.writableDatabase 
val uriReturn = when (uriMatcher.match(uri)) { 
bookDir, bookItem -> { 
val newBookId = db.insert("Book", null, values) 
Uri.parse("content://$authority/book/$newBookId") 


F 

categoryDir, categoryItem -> { 
val newCategoryId = db.insert("Category", null, values) 
Uri.parse("content://$authority/category/$newCategoryId") 


} 

else -> null 
} 
uriReturn 


} 


override fun update(uri: Uri, values: ContentValues?, selection: String?, 
selectionArgs: Array<String>?) = dbHelper?.let { 
// 更 新 数据 
val db = it.writableDatabase 
val updatedRows = when (uriMatcher.match(uri)) { 
bookDir -> db.update("Book", values, selection, selectionArgs) 
bookItem -> { 
val bookId = uri.pathSegments[1] 
db.update("Book", values, "id = ?", array0f (bookId)) 


} 
categoryDir -> db.update("Category", values, selection, selectionArgs) 
CategoryItem -> { 

val categoryId = uri.pathSegments[1] 

db.update("Category", values, "id = ?", array0f(categoryId)) 


} 
else -> 0 
updatedRows 


} ?: 0 


override fun delete(uri: Uri, selection: String?, selectionArgs: Array<String>?) 
= dbHelper?.let { 
// 删除 数 和 


HU 
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val db = it.writabLeDatabase 
val deletedRows = when (uriMatcher.match(uri)) { 
bookDir -> db.delete("Book", selection, selectionArgs) 
bookItem -> { 
val bookId = uri.pathSegments[1] 
db.delete("Book", "id = ?", array0f(bookId)) 


categoryDir -> db.delete("Category", selection, selectionArgs) 
CategoryItem -> { 

val categoryId = uri.pathSegments[1] 

db.delete("Category", "id = ?", array0f(categoryId)) 


else -> 0 


} 
deletedRows 
} ?: 0 


override fun getType(uri: Uri) = when (uriMatcher.match(uri)) { 
bookDir -> "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.book" 
bookItem -> "vnd.android.cursor.item/vnd.com.example.databasetest.provider.book" 
categoryDir -> "vnd.android.cursor.dir/vnd.com.example.databasetest. 
provider.category" 
categoryItem -> "vnd.android.cursor.item/vnd.com.example.databasetest. 
provider.category" 
else -> null 
} 
} 


代码 虽然 很 长 ， 不 过 不 用 担心 ,这些 内 容 都 不 难 理解 ， 因 为 使 用 的 全 部 都 是 上 一 小 节 中 我 们 学 
到 的 知识 。 首 先 ， 在 类 的 一 开始 ， 同 样 是 定义 了 4 个 变量 ， 分 别 用 于 表示 访问 Book 表 中 的 所 有 
数据 、 访 问 Book 表 中 的 单条 数据 、 访 问 Category 表 中 的 所 有 数据 和 访问 Category 表 中 的 单条 
数据 。 然 后 在 一 个 by Lazy 代 码 块 里 对 UriMatcher 进 行 了 初始 化 操作 ， 将 期 望 匹 配 的 几 种 
URI 格 式 添 加 了 进去 。by lazy 代 码 块 是 Kotlin 提 供 的 一 种 懒 加 载 技术 ， 代码 块 中 的 代码 一 开始 
并 不 会 执行 ， 只 有 当 uriMatcher 变 量 首 次 被 调用 的 时 候 才 会 执行 ， 并 且 会 将 代码 块 中 最 后 一 
行 代 码 的 返回 值 赋 给 uriMatcher。 我 们 将 在 本 章 的 Kotlin 课 堂 里 讨论 关于 by Lazy 的 更 多 内 
容 。 


接 下 来 就 是 每 个 抽象 方法 的 具体 实现 了 ， 先 来 看 一 下 onCreate ( ) 方 法 。 这 个 方法 的 代码 很 

短 ， 但 是 语法 可 能 有 点 特殊 。 这 里 我 们 综合 利用 了 Getter 方 法 语法 糖 、? .操作 符 、Let 函 

数 、? :操作 符 以 及 单行 代码 浮 数 语法 糖 。 首 先 调 用 了 getContext( ) 方 法 并 借助 ? .操作 符 和 
let 也 数 判断 它 的 返回 值 是 否 为 空 : 如 果 为 空 就 使 用 ? :操作 符 返回 false , 表示 
ContentProvider 初 始 化 失败 ; 如 果 不 为 空 就 执行 Let 函 数 中 的 代码 。 在 Let 函 数 中 创建 了 一 个 
MyDatabaseHeLper 的 实例 , 然后 返回 true 表 示 ContentProvider 初 始 化 成 功 。 由 于 我 们 借 
助 了 多 个 操作 符 和 标准 函数 ， 因 此 这 段 逻辑 是 在 一 行 表达 式 内 完成 的 ， 符 合 单行 代码 函数 的 语 
法 糖 要 求 ， 所 以 直接 用 等 号 连接 返回 值 即 可 。 其 他 几 个 方法 的 语法 结构 是 类 似 的 ， 相 信 你 应 该 
能 看 得 明白 。 


接着 看 一 下 query ( ) 方 法 ， 在 这 个 方法 中 先 获 取 了 SQLiteDatabase 的 实例 ， 然 后 根据 传 入 的 
Uri 参 数 判 断 用 户 想 要 访问 哪 张 表 ,再 调用 SQLiteDatabase 的 que ry ( ) 进行 查询 ， 并 将 
Cursor 对 象 返回 就 好 了 。 注 意 ， 当 访问 单条 数据 的 时 候 ， 调 用 了 Uri 对 象 的 
getPathSegments() 方 法 ，, 它 会 将 内 容 URI 权 限 之 后 的 部 分 以 “/" 符 号 进行 分 害 |, 并 把 分 割 | 后 
的 结果 放 入 一 个 字符 串 列表 中 ， 那 这 个 列表 的 第 0 个 位 置 存放 的 就 是 路 径 ， 第 1 个 位 置 存放 的 就 


www.blogss.cn 


是 id 了 。 得 到 了 id 之 后 ， 再 通过 seLection 和 seLectionArgs 参 数 进行 约束 ， 就 实现 了 查询 
单条 数据 的 功能 。 


再 往 后 就 是 insert ( ) 方 法 , 它 也 是 先 获 取 了 SQLiteDatabase 的 实例 ， 然 后 根据 传 入 的 Uri 参 
数 判断 用 户 想 要 往 哪 张 表 里 添 加 数据 ,再 调用 SQLiteDatabase 的 insert( ) 方 法 进行 添加 就 可 
以 了 。 注 意 , insert() 方 法 要 求 返回 一 个 能 够 表示 这 条 新 增 数据 的 URI , 所 以 我 们 还 需要 调用 
Uri.parse() 方 法 ,将 一 个 内 容 URI 解 析 成 Uri 对 象 ， 当 然 这 个 内 容 URI 是 以 新 增 数据 的 id 结尾 
的 。 


接 下 来 就 是 update ( ) 方 法 了 ， 相 信 这 个 方法 中 的 代码 已 经 完全 难 不 倒 你 了 ， 也 是 先 获取 
SQLiteDatabase 的 实例 ， 然 后 根据 传 入 的 uri 参 数 判断 用 户 想 要 更 新 哪 张 表 里 的 数据 ， 再 调用 
SQLiteDatabase 的 update ( ) 方 法 进行 更 新 就 好 了 ， 受 影响 的 行 数 将 作为 返回 值 返回 。 


下 面 是 deLete ( ) 方 法 ， 是 不 是 感觉 越 到 后 面 越 轻松 了 ? 因为 你 已 经 渐 入 佳境 ,真正 找到 | 寄 门 
了 。 这 里 仍然 是 先 获 取 SQLiteDatabase 的 实例 ， 然 后 根据 传 入 的 uri 参 数 判断 用 户 想 要 删除 哪 
张 表 里 的 数据 ， 再 调用 SQLiteDatabase 的 deLete ( ) 方 法 进行 删除 就 好 了 “， 被 删除 的 行 数 将 作 
为 返回 值 返 回 。 

最 后 是 getType ( ) 方 法 , 这 个 方法 中 的 代码 完全 是 按照 上 一 节 中 介绍 的 格式 规则 编写 的 ， 相 信 
已 经 没有 解释 的 必要 了 。 这 样 我 们 就 将 ContentProvider 中 的 代码 全 部 编写 完了 。 


另外 ,还 有 一 点 需要 注意 ，ContentProvider 一 定 要 在 AndroidManifest.xm| 文 件 中 注册 才 可 
以 使 用 。 不 过 幸运 的 是 ， 我 们 是 使 用 Android Studio 的 快捷 方式 创建 的 ContentProvider ， 
此 注册 这 一 步 已 经 自动 完成 了 。 打 开 AndroidManifest.xm| 文 件 瞧 一 瞧 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.databasetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:roundIcon="@mipmap/ic launcher round" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<provider 
android:name=" .DatabaseProvider" 
android:authorities="com.example.databasetest.provider" 
android:enabled="true" 
android:exported="true"> 
</provider> 
</application> 


</manifest> 


可 以 看 到 ，<application> 标 签 内 出 现 了 一 个 新 的 标签 <provider> , 我 们 使 用 它 来 对 
DatabaseProvider 进 行 注册 。android:name 属 性 指定 了 DatabaseProvider 的 类 名 ， 
android:authorities 属 性 指定 了 DatabaseProvider 的 authority , 而 enabLed 和 

exported 属 性 则 是 根据 我 们 刚才 勾 选 的 状态 自动 生成 的 ， 这 里 表示 人 允许 DatabaseProvider 被 
其 他 应 用 程序 访问 。 
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现在 DatabaseTest 这 个 项 目 就 已 经 拥有 了 跨 程 序 共享 数据 的 功能 了 ， 我 们 赶快 来 尝试 一 下 。 首 
需要 将 DatabaseTest 程 序 从 模拟 器 中 删除 ,以 防止 上 一 章 中 产生 的 遗留 数据 对 我 们 造成 干 
扰 。 然 后 运行 一 下 项 目 ， 将 DatabaseTest 程 序 重新 安装 在 模拟 器 上 。 接 着 关闭 DatabaseTest 
这 个 项 目 ， 并 创建 一 个 新 项 目 ProviderTest , 我 们 将 通过 这 个 程序 去 访问 DatabaseTest 中 的 数 

据 。 


还 是 先 来 编写 一 下 布局 文件 吧 ,修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/addData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Add To Book" /> 


<Button 
android:id="@+id/queryData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Query From Book" /> 


<Button 
android:id="@+id/updateData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Update Book" /> 


<Button 
android:id="@+id/deleteData" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Delete From Book" /> 


</LinearLayout> 


布局 文件 很 简单 ， 里 面 放置 了 4 个 按钮 ,分别 用 于 添加 、 查 询 、 更 新 和 删除 数据 。 然 后 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
var bookId: String? = null 


override fun onCreate(savedInstanceState: Bundle?) { 

super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
addData.setOnClickListener { 

// 添加 数据 

val uri = Uri.parse("content://com.example.databasetest.provider/book") 

val values = contentValues0Of("name" to "A Clash of Kings", 

"author" to "George Martin", "pages" to 1040, "price" to 22.85) 
val newUri = contentResolver.insert(uri, values) 
bookId = newUri?.pathSegments?.get(1) 


} 
queryData.setOnClickListener { 


// 查询 数据 
val uri = Uri.parse("content://com.example.databasetest.provider/book") 
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contentResolver.query(uri, null, null, null, null)?.apply { 
while (moveToNext()) { 
val name = getString(getColumnIindex("name")) 
val author = getString(getColumnIndex("author")) 
val pages = getInt(getColumnIndex("pages")) 
val price = getDouble(getColumnIndex("price")) 


Log.d("MainActivity", "book name is $name") 
Log.d("MainActivity", "book author is $author") 
Log.d("MainActivity", "book pages is $pages") 
Log.d("MainActivity", "book price is $price") 

} 

close() 


} 


} 
updateData.setOnClickListener { 
// 更 新 数据 
bookId?.let { 
val uri = Uri.parse("content://com.example.databasetest.provider/ 
book/$it") 
val values = contentValues0Of("name" to "A Storm of Swords", 
"pages" to 1216, "price" to 24.05) 
contentResolver.update(uri, values, null, null) 


} 
} 
deleteData.setOnClickListener { 
// 删除 数据 
bookId?.Let { 
val uri = Uri.parse("content://com.example.databasetest.provider/ 
book/$it") 
contentResolver.delete(uri, null, null) 


} 


可 以 看 到 ， 我们 分 别 在 这 4 个 按钮 的 点 击 事件 里 面 处 理 了 增删 改 查 的 逻辑 。 添 加 数据 的 时 候 ，, 首 
先 调用 了 Uri .parse() 方 法 将 一 个 内 容 URI 解 析 成 Uri 对 象 ， 然 后 把 要 添加 的 数据 都 存放 到 
ContentValues 对 象 中 ， 接 着 调用 ContentResolver 的 ijnsert() 方 法 执行 添加 操作 就 可 以 
了 。 注 意 , insert ( ) 方 法 会 返回 一 个 Uri 对 象 ， 这 个 对 象 中 包含 了 新 增 数据 的 id， 我们 通过 
getPathSegments ( ) 方 法 将 这 个 id 取出 ， 稍 后 会 用 到 它 。 


查询 数据 的 时 候 ， 同 样 是 调用 了 Uri,parse() 方 法 将 一 个 内 容 URI 解 析 成 Uri 对 象 ， 然 后 调用 
ContentResolver 的 query ( ) 方 法 查询 数据 , 查询 的 结果 当然 还 是 存放 在 Cursor 对 象 中 。 之 
后 对 Cursor 进 行 遍历 ， 从 中 取出 查询 结果 ， 并 一 一 打印 出 来 。 


更 新 数据 的 时 候 ， 也 是 先 将 内 容 URI 解 析 成 Uri 对 象 ， 然 后 把 想 要 更 新 的 数据 存放 到 | 
ContentValues 对 象 中 ， 再 调用 ContentResolver 的 update() 方 法 执行 更 新 操作 就 可 以 
了 。 注 意 , 这 里 我 们 为 了 不 想 让 Book 表 中 的 其 他 行 受到 影响 ， 在 调用 Uri .parse() 方 法 时 ， 
给 内 容 URI 的 尾部 增加 了 一 个 id ，, 而 这 个 id 正 是 添加 数据 时 所 返回 的 。 这 就 表示 我 们 只 希望 更 新 
刚刚 添加 的 那 条 数据 ，Book 表 中 的 其 他 行 都 不 会 受 影响 。 


删除 数据 的 时 候 ， 也 是 使 用 同样 的 方法 解析 了 一 个 以 id 结尾 的 内 容 URI , 然后 调用 


ContentResoLver 的 deLete( ) 方 法 执行 删除 操作 就 可 以 了 。 由 于 我 们 在 内 容 URI 里 指定 了 一 
个 id ， 因 此 只 会 删 掉 拥 有 相应 id 的 那 行 数据 ，Book 表 中 的 其 他 数据 都 不 会 受 影响 。 


www.blogss.cn 


现在 运行 一 下 ProviderTest 项 目 ， 会 显示 如 图 8.14 所 示 的 界面 。 


10:32 


ProviderTest 


ADD TO BOOK 
QUERY FROM BOOK 
UPDATE BOOK 


DELETE FROM BOOK 


图 8.14 ProviderTest 主 界面 


点 击 一 下 “Add To Book" 按 钮 ， 此 时 数据 就 应 该 已 经 添加 到 DatabaseTest 程 序 的 数据 库 中 了 ， 
我 们 可 以 通过 点 击 “Query From Book” 按 钮 进行 检查 ， 打 印 日 志 如 图 8.15 所 示 。 


com.example.providertest (504) Verbose | Qr- 


com.example.providertest D/MainActivity: book name is A Clash of Kings 
com.example.providertest D/MainActivity: book author is George Martin 
com.example.providertest D/MainActivity: book pages is 1040 
com,exampLe,providertest D/MainActivity: book price is 22.85 


图 8.15 ”查询 添加 的 数据 
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然后 点 击 一 下 "Update Book" 按 钮 更 新 数据 ,再 点 击 一 下 "Query From Book" 按 钮 进行 检 
查 ， 结 果 如 图 8.16 所 示 。 


com.example.providertest (504) ”于 Verbose “地 Qr 


com.example.providertest D/MainActivity: book name is A Storm of Swords 
com.example.providertest D/MainActivity: book author is George Martin 
com.example.providertest D/MainActivity: book pages is 1216 
com.example.providertest D/MainActivity: book price is 24.05 


图 8.16 ”查询 更 新 后 的 数据 


最 后 点 击 “Delete From Book” 按 钮 删除 数据 ， 此 时 再 点 击 “Query From Book” 按 钮 就 查询 不 
到 数据 了 。 由 此 可 以 看 出 ， 我 们 的 跨 程序 共享 数据 功能 已 经 成 功 实 现 了 ! 现在 不 仅 是 
ProviderTest 程 序 ,任何 一 个 程序 都 可 以 轻松 访问 DatabaseTest 中 的 数据 ,而 且 我 们 还 丝毫 不 
用 担心 隐私 数据 泄漏 的 问题 。 


到 这 里 ,与 ContentProvider 相 关 的 重要 内 容 就 基本 全 部 介绍 完了 ， 下面 就 让 我 们 进入 本 章 的 
Kotlin 课 堂 ， 学 习 更 多 Kotlin 的 高 级 知识 。 
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8.5 ”Kotlin 课 堂 : 泛 型 和 委托 


本 章 的 Kotlin 课 堂 我 们 将 继续 学 习 一 些 新 的 高 级 知识 : 泛 型 和 委托 。 其 实在 前 面 的 章节 中 我 们 已 
经 使 用 过 好 几 次 泛 型 了 ， 只 是 还 没有 系统 地 介绍 过 ， 而 委托 则 是 一 个 全 新 的 主题 内 容 。 那 么 在 
这 节 Kotlin 课 堂 里 ， 我 们 就 针对 这 两 块 主题 内 容 进 行 学 习 。 


8.5.1 泛 型 的 基本 用 法 


准确 来 讲 ， 泛 型 并 不 是 什么 新 鲜 的 事物 。Java 早 在 1.5 版 本 中 就 引入 了 泛 型 的 机 制 ，Kotlin 自 然 
也 就 支持 了 泛 型 功能 。 但 是 Kotlin 中 的 泛 型 和 java 中 的 泛 型 有 同 有 异 。 我 们 在 本 小 节 中 就 先 学 习 
泛 型 的 基本 用 法 ， 也 就 是 和 java 中 相同 的 部 分 ,然后 在 第 10 章 的 Kotlin 课 堂 中 再 延伸 学 习 
Kotlin 特 有 的 泛 型 功能 。 

首先 解释 一 下 什么 是 泛 型 。 在 一 般 的 编程 模式 下 ， 我 们 需要 给 任何 一 个 变量 指定 一 个 具体 的 类 
型 ， 而 泛 型 允许 我 们 在 不 指定 具体 类 型 的 情况 下 进行 编程 ， 这 样 编写 出 来 的 代码 将 会 拥有 更 好 
的 扩展 性 。 

举 个 例子 ，List 是 一 个 可 以 存放 数据 的 列表 ， 但 是 List 并 没有 限制 我 们 只 能 存放 整 型 数据 或 字符 
串 数 据 ， 因 为 它 没有 指定 一 个 具体 的 类 型 ， 而 是 使 用 泛 型 来 实现 的 。 也 正 是 如 此 ， 我 们 才 可 以 
使 用 List<Int>、List<String> 之 类 的 语法 来 构建 具体 类 型 的 列表 。 

那么 要 怎样 才能 定义 自己 的 泛 型 实现 呢 ? 这 里 我 们 来 学 习 一 下 基本 的 语法 。 


泛 型 主要 有 两 种 定义 方式 : 一 种 是 定义 泛 型 类 ， 另 一 种 是 定义 泛 型 方法 ， 使 用 的 语法 结构 都 是 
<T>。 当 然 括号 内 的 T 并 不 是 固定 要 求 的 ， 事 实 上 你 使 用 任何 英文 字母 或 单词 都 可 以 ， 但 是 通常 
情况 下 ，T 是 一 种 约定 俗 成 的 泛 型 写法 。 


如 果 我 们 要 定义 一 个 泛 型 类 ， 就 可 以 这 么 写 : 


class MyClass<T> { 


fun method(param: T): T { 
return param 


} 


此 时 的 MyClass 就 是 一 个 泛 型 类 ,MyClass 中 的 方法 允许 使 用 T 类 型 的 参数 和 返回 值 。 


我 们 在 调用 MyCLass 类 和 method ( ) 方 法 的 时 候 ， 就 可 以 将 泛 型 指定 成 具体 的 类 型 ， 如 下 所 
小 : 


val myCLass = MyClass<Int>() 
val result = myClass.method(123) 


这 里 我 们 将 MyCLass 类 的 泛 型 指定 成 Int 类 型 ， 于 是 method ( ) 方 法 就 可 以 接收 一 个 Int 类 型 的 
参数 ， 并 且 它 的 返回 值 也 变 成 了 Int 类 型 。 


www.blogss.cn 


而 如 果 我 们 不 想 定义 一 个 泛 型 类 ,只 是 想 定 义 一 个 泛 型 方法 ， 应 该 要 怎么 写 呢 ? 也 很 简单 ， 只 
需要 将 定义 泛 型 的 语法 结构 写 在 方法 上 面 就 可 以 了 ， 如 下 所 示 : 
class MyClass { 


fun <T> method(param: T): T { 
return param 
} 


} 


此 时 的 调用 方式 也 需要 进行 相应 的 调整 : 


val myClass = MyClass() 
val result = myClass.method<Int>(123) 


可 以 看 到 ， 现 在 是 在 调用 method ( ) 方 法 的 时 候 指 定 泛 型 类 型 了 。 另 外 ，Kotlin 还 拥有 非常 出 色 
的 类 型 推导 机 制 ， 例 如 我 们 传 入 了 一 个 Int 类 型 的 参数 ， 它 能 够 自动 推导 出 泛 型 的 类 型 就 是 Int 
型 ,因此 这 里 也 可 以 直接 省 略 泛 型 的 指定 : 


val myClass = MyClass() 
val result = myClass.method(123) 


Kotlin 还 人 允许 我 们 对 泛 型 的 类 型 进行 限制 。 目 前 你 可 以 将 method ( ) 方 法 的 泛 型 指定 成 任意 类 
型 ,但 是 如 果 这 并 不 是 你 想 要 的 话 ， 还 可 以 通过 指定 上 界 的 方式 来 对 泛 型 的 类 型 进行 约束 ， 比 
如 这 里 将 method ( ) 方 法 的 泛 型 上 界 设置 为 Number 类 型 ， 如 下 所 示 : 


class MyCLass { 


fun <T : Number> method(param: T): T { 
return param 


} 


这 种 写法 就 表明 ， 我 们 只 能 将 method ( ) 方 法 的 泛 型 指定 成 数字 类 型 ， 比 如 Int、FLoat、 
Double 等 。 但 是 如 果 你 指定 成 字符 串 类 型 ， 就 肯定 会 报错 ， 因 为 它 不 是 一 个 数字 。 

另外 ,在 默认 情况 下 ， 所 有 的 泛 型 都 是 可 以 指定 成 可 空 类 型 的 ， 这 是 因为 在 不 手动 指定 上 界 的 
时 候 ， 泛 型 的 上 界 默认 是 Any?。 而 如 果 想 要 让 泛 型 的 类 型 不 可 为 空 ， 只 需要 将 泛 型 的 上 界 于 动 
指定 成 Any 就 可 以 了 。 

接 下 来 ， 我 们 尝试 对 本 小 节 所 学 的 泛 型 知识 进行 应 用 。 回 想 一 下 ,在 6.5.1 小 节 学 习 高 阶 函 数 的 
时 候 ， 我 们 编写 了 一 个 buiLd 函 数 ， 代 码 如 下 所 示 : 


fun StringBuilder.build(block: StringBuilder.() -> Unit): StringBuilder { 
block() 
return this 


} 


这 个 函数 的 作用 和 apptLy 上 函数 基本 是 一 样 的 ,只 是 buitLd 函 数 只 能 作用 在 stringBuitLder 类 上 
面 ，, 而 apply 嘱 数 是 可 以 作用 在 所 有 类 上 面 的 。 现 在 我 们 就 通过 本 小 节 所 学 的 泛 型 知识 对 
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buitLd 函 数 进行 扩展 ， 让 它 实 现 和 appLy 范 数 完全 一 样 的 功能 。 


思考 一 下 ， 其 实 并 不 复杂 ， 只 需要 使 用 <T> 将 build 陶 数 定义 成 泛 型 渍 数 ， 再 将 原来 所 有 强制 | 指 
定 StringBuilder 的 地 方 都 替换 成 T 就 可 以 了 。 新 建 一 个 build.kt 文 件 ， 并 编写 如 下 代码 : 


fun <T> T.build(block: T.() -> Unit): T { 
block() 
return this 


} 


大 功 告 成 ! 现在 你 完全 可 以 像 使 用 appLy 函 数 一 样 去 使 用 buiLd 函 数 了 ， 比 如 说 这 里 我 们 使 用 
buitLd 范 数 简化 Cursor 的 遍历 : 


contentResolver.query(uri, null, null, null, null)?.build { 
while (moveToNext()) { 


close() 


} 


好 了 ， 关 于 Kotlin 泛 型 的 基本 用 法 就 介绍 到 这 里 ， 这 部 分 用 法 和 java 中 的 泛 型 基本 上 没什么 区 
别 ， 所 以 应 该 还 是 比较 好 理解 的 。 接 下 来 我 们 进入 本 节 Kotlin 课 堂 的 另 一 个 重要 主题 一 一 委托 。 


8.5.2 类 委托 和 委托 属性 


委托 是 一 种 设计 模式 ， 它 的 基本 理念 是 : 操作 对 象 自己 不 会 去 处 理 某 段 逻辑 ,而 是 会 把 工作 委 
托 给 另外 一 个 辅助 对 象 去 处 理 。 这 个 概念 对 于 java 程 序 员 来 讲 可 能 相对 比较 陌生 ， 因 为 java 对 
于 委托 并 没有 语言 层级 的 实现 ， 而 像 C# 等 语言 就 对 委托 进行 了 原生 的 支持 。 


Kotlin 中 也 是 支持 委托 功能 的 ， 并 且 将 委托 功能 分 为 了 两 种 : 类 委托 和 委托 属性 。 下 面 我 们 逐个 


进行 学 习 。 


首先 来 看 类 委托 ， 它 的 核心 思想 在 于 将 一 个 类 的 具体 实现 委托 给 另 一 个 类 去 完成 。 在 前 面 的 章 
节 中 ， 我们 曾经 使 用 过 Set 这 种 数据 结构 ， 它 和 List 有 点 类 似 , 只 是 它 所 存储 的 数据 是 无 序 
的 ， 并 且 不 能 存储 重复 的 数据 。Set 是 一 个 接口 ， 如果 要 使 用 它 的 话 ， 需 要 使 用 它 具 体 的 实现 
类 ,比如 HashSet。 而 借助 于 委托 模式 ,我 们 可 以 轻松 实现 一 个 自己 的 实现 类 。 比 如 这 里 定义 
一 个 MySet ,并 让 它 实现 Set 接 口 ,代码 如 下 所 示 : 


class MySet<T>(val helperSet: HashSet<T>) : Set<T> { 


override val size: Int 
get() = helperSet.size 


override fun contains(element: T) = helperSet.contains (element) 
override fun containsAll(elements: Collection<T>) = helperSet.containsAll(elements) 
override fun isEmpty() = helperSet.isEmpty() 


override fun iterator() = helperSet.iterator() 
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可 以 看 到 ，MySet 的 构造 永 数 中 接收 了 一 个 HashSet 参 数 ,这 就 相当 于 一 个 辅助 对 象 。 然 后 在 
Set 接 口 所 有 的 方法 实现 中 ， 我 们 都 没有 进行 自己 的 实现 ， 而 是 调用 了 辅助 对 象 中 相应 的 方法 实 
现 ， 这 其 实 就 是 一 种 委托 模式 。 


那么 ,这 种 写法 的 好 处 是 什么 呢 ? 既然 都 是 调用 辅助 对 象 的 方法 实现 ， 那 还 不 如 直接 使 用 辅助 
对 象 得 了 。 这 人 么 说 确实 没 错 ， 但 如 果 我 们 只 是 让 大 部 分 的 方法 实现 调用 辅助 对 象 中 的 方法 ， 少 
部 分 的 方法 实现 由 自己 来 重 写 ， 甚 至 加 入 一 些 自己 独 有 的 方法 ， 那 么 MySet 就 会 成 为 一 个 全 新 
的 数据 结构 类 ,这 就 是 委托 模式 的 意义 所 在 。 


但 是 这 种 与 法 也 有 一 定 的 弊端 ， 如 果 接 口中 的 待 实现 方法 比较 少 还 好 ， 要 是 有 几 十 甚至 上 百 个 
方法 的 话 ， 每 个 都 去 这 样 调用 辅助 对 象 中 的 相应 方法 实现 ， 那 可 真是 要 写 活 了 。 那 么 这 个 问题 
有 没有 什么 解决 方案 呢 ? 在 Java 中 确实 没有 ， 但 是 在 Kotlin 中 可 以 通过 类 委托 的 功能 来 解决 。 


Kotlin 中 委托 使 用 的 关键 字 是 by， 我们 只 需要 在 接口 声明 的 后 面 使 用 by 关键 字 ， 再 接 上 受 委 托 
的 辅助 对 象 ， 就 可 以 免 去 之 前 所 写 的 一 大 堆 模 板式 的 代码 了 ， 如 下 所 示 : 


class MySet<T>(val helperSet: HashSet<T>) : Set<T> by helperSet { 
} 


这 两 段 代码 实 现 的 效果 是 一 模 一 样 的 ， 但 是 借助 了 类 委托 的 功能 之 后 ， 代码 明显 简化 了 太 多 。 
另外 ， 如 果 我 们 要 对 某 个 方法 进行 重新 实现 ， 只 需要 单独 重 写 那 一 个 方法 就 可 以 了 ， 其 他 的 方 
法 仍然 可 以 享受 类 委托 所 带 来 的 便利 ， 如 下 所 示 : 


class MySet<T>(val helperSet: HashSet<T>) : Set<T> by helperSet { 
fun helloWworld() = println("Hello World") 


override fun isEmpty() = false 


} 
这 里 我 们 新 增 了 一 个 heLLoWortd ( ) 方 法 ， 并 且 重 写 了 isEmpty() 方 法 ， 让 它 永 远 返 回 
faLse。 这 当然 是 一 种 错误 的 做 法 ,这 里 仅仅 是 为 了 演示 一 下 而 已 。 现 在 我 们 的 MySet 就 成 为 
了 一 个 全 新 的 数据 结构 类 ， 它 不 仅 永 远 不 会 为 空 ， 而 且 还 能 打印 heLLowortLd ( ) ,至 于 其 他 
Set 接 口中 的 功能 ， 则 和 HashSet 保 持 一 致 。 这 就 是 Kotlin 的 类 委托 所 能 实现 的 功能 。 


掌握 了 类 委托 之 后 ， 接 下 来 我 们 开始 学 习 委 托 属性 。 它 的 基本 理念 也 非常 容易 理解 ， 真 正 的 难 
点 在 于 如 何 灵 活 地 进行 应 用 。 


类 委托 的 核心 思想 是 将 一 个 类 的 具体 实现 委托 给 另 一 个 类 去 完成 ， 而 委托 属性 的 核心 思想 是 将 
一 个 属性 (字段 ) 的 具体 实现 委托 给 另 一 个 类 去 完成 。 


我 们 看 一 下 委托 属性 的 语法 结构 ， 如 下 所 示 : 


class MyClass { 


var p by Delegate() 
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可 以 看 到 ， 这 里 使 用 by 关键 字 连 接 了 左边 的 p 属 性 和 右边 的 DeLegate 实 例 ， 这 是 什么 意思 呢 ? 
这 种 写法 就 代表 着 将 p 属 性 的 具体 实现 委托 给 了 Delegate 类 去 完成 。 当 调用 p 属 性 的 时 候 会 自 
动 调 用 DeLegate 类 的 getVatLue () 方 法 ， 当 给 p 属 性 赋值 的 时 候 会 自动 调用 DeLegate 类 的 
setValue() 方 法 。 


因此 ， 我 们 还 得 对 Detegate 类 进行 具体 的 实现 才 行 ， 代 码 如 下 所 示 : 


class Delegate { 
var propValue: Any? = null 
operator fun getValue(myClass: MyClass, prop: KProperty<*>): Any? { 
return propValue 


} 


operator fun setValue(myClass: MyClass, prop: KProperty<*>, value: Any?) { 
propValue = value 


} 


这 是 一 种 标准 的 代码 实现 模板 ， 在 Delegate 类 中 我 们 必须 实现 getValue( ) 和 setValue() 这 
两 个 方法 ， 并 且 都 要 使 用 ope rator 关 键 子 进行 声明 。 


getValue( ) 方 法 要 接收 两 个 参数 : 第 一 个 参数 用 于 声明 该 DeLegate 类 的 委托 功能 可 以 在 什么 
类 中 使 用 ， 这 里 写成 MyClass 表 示 仅 可 在 MyClass 类 中 使 用 ; 第 二 个 参数 KProperty<*> 是 
Kotlin 中 的 一 个 属性 操作 类 ， 可 用 于 获取 各 种 属性 相关 的 值 ， 在 当前 场景 下 用 不 着 ,但 是 必须 在 
方法 参数 上 进行 声明 。 另 外 ，<*> 这 种 泛 型 的 写法 表示 你 不 知道 或 者 不 关心 泛 型 的 具体 类 型 ,只 
是 为 了 通过 语法 编译 而 已 ,， 有 点 类 似 于 Java 中 <?> 的 写法 。 至 于 返回 值 可 以 声明 成 任何 类 型 , 根 
据 具 体 的 实现 逻辑 去 写 就 行 了 ,上述 代码 只 是 一 种 示例 写法 。 


setVatLue ( ) 方 法 也 是 相似 的 ， 只 不 过 它 要 接收 3 个 参数 。 前 两 个 参数 和 getVaLue ( ) 方 法 是 相 
同 的 ， 最 后 一 个 参数 表示 具体 要 赋值 给 委托 属性 的 值 , 这 个 参数 的 类 型 必须 和 getVaLue ( ) 方 
法 返回 值 的 类 型 保持 一 致 。 


整个 委托 属性 的 工作 流程 就 是 这 样 实现 的 ， 现 在 当 我 们 给 MyCLass 的 p 属 性 赋值 时 ， 就 会 调用 
DeLegate 类 的 setVatLue( ) 方 法 , 当 获 取 MyCLass 中 p 属 性 的 值 时 ， 就 会 调用 DeLegate 类 的 
getValue() 方 法 。 是 不 是 很 好 理解 ? 


不 过 ， 其实 还 存在 一 种 情况 可 以 不 用 在 Delegate 类 中 实现 setValue() 方 法 ， 那 就 是 
MyClass 中 的 p 属 性 是 使 用 val 关 键 字 声明 的 。 这 一 点 也 很 好 理解 ， 如果 p 属 性 是 使 用 val 关 键 
字 声 明 的 ， 那 么 就 意味 着 p 属 性 是 无 法 在 初始 化 之 后 被 重新 赋值 的 ， 因 此 也 就 没有 必要 实现 
setValue() 方 法 ,只 需要 实现 getValue() 方 法 就 可 以 了 。 

好 了 ， 关 于 Kotlin 的 委托 功能 我 们 就 学 到 这 里 。 正 如 前 面 所 说 ， 委托 功 能 本 身 不 难 理解 ， 真正 的 
难点 在 于 如 何 灵 活 地 进行 应 用 。 那 么 接 下 来 ， 我 们 就 通过 一 个 示例 来 学 习 一 下 委托 功能 具体 的 
应 用 。 


8.5.3 实现 一 个 自己 的 Lazy 范 数 
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在 8.4.2 人 小节 初 始 化 uriMatcher 变 量 的 时 候 ， 我 们 使 用 了 一 种 懒 加 载 技术 。 把 想 要 延迟 执行 的 
代码 放 到 by Lazy 代 码 块 中 ， 这样 代 码 块 中 的 代码 在 一 开始 的 时 候 就 不 会 执行 ,只 有 当 
uriMatcher 变 量 首次 被 调用 的 时 候 ， 代 码 块 中 的 代码 才 会 执行 。 


那么 学 习 了 Kotlin 的 委托 功能 之 后 ， 我 们 就 可 以 对 by Lazy 的 工作 原理 进行 解密 了 ， 它 的 基本 
语法 结构 如 下 : 


val p by lazy { ... } 


现在 再 来 看 这 段 代码 ， 是 不 是 觉得 更 有 头绪 了 呢 ? 实际 上 , by Lazy 并 不 是 连 在 一 起 的 关键 

字 , 只 有 by 才 是 Kotlin 中 的 关键 字 ，Lazy 在 这 里 只 是 一 个 高 阶 函 数 而 已 。 在 Lazy 函 数 中 会 创建 
并 返回 一 个 Delegate 对 象 ， 当 我 们 调用 p 属 性 的 时 候 ， 其 实 调用 的 是 Delegate 对 象 的 
getVatue() 方 法 ， 然 后 getVatLue () 方 法 中 又 会 调用 Lazy 函 数 传 入 的 Lambda 表 达 式 ， 这 样 
表达 式 中 的 代码 就 可 以 得 到 执行 了 ， 并 且 调 用 p 属 性 后 得 到 的 值 就 是 Lambda 表 达 式 中 最 后 一 行 
代码 的 返回 值 。 


这 样 看 来 ，Kotlin 的 懒 加 载 技 术 也 并 没有 那么 神秘 ， 掌 握 了 它 的 实现 原理 之 后 ,我们 也 可 以 实现 
一 个 自己 的 Lazy 贞 数 。 


那么 话 不 多 说 ， 开 始 动手 吧 。 新 建 一 个 Later kt 文件 ， 并 编写 如 下 代码 : 


class Later<T>(val block: () -> T) { 
} 


这 里 我 们 首先 定义 了 一 个 Later 类 ， 并 将 它 指 定 成 泛 型 类 。Later 的 构造 亢 数 中 接收 一 个 函数 
类 型 参数 ， 这 个 水 数 类 型 参数 不 接收 任何 参数 ， 并 且 返 回 值 类 型 就 是 Later 类 指定 的 泛 型 。 


接着 我 们 在 Later 类 中 实现 getValue() 方 法 ,代码 如 下 所 示 : 


class Later<T>(val block: () -> T) { 

var value: Any? = null 

operator fun getValue(any: Any?, prop: KProperty<*>): T { 
if (value == null) { 


value = block() 


return value as T 


} 


} 


这 里 将 getValue ( ) 方 法 的 第 一 个 参数 指定 成 了 Any? 类 型 ， 表 示 我 们 希望 Later 的 委托 功能 在 
所 有 类 中 都 可 以 使 用 。 然 后 使 用 了 一 个 vaLue 变 量 对 值 进行 缓存 ， 如 果 vatLue 为 空 就 调用 构造 
级 数 中 传 入 的 冰 数 类 型 参数 去 获取 值 ， 人 否则 就 直接 返回 。 


由 于 懒 加 载 技术 是 不 会 对 属性 进行 赋值 的 ， 因 此 这 里 我 们 就 不 用 实现 setVatue( ) 方 法 了 。 


代码 与 到 这 里 ， 委 托 属 性 的 功能 就 已 经 完成 了 。 虽 然 我 们 可 以 立刻 使 用 它 ， 不 过 为 了 让 它 的 用 
法 更 加 类 似 于 Lazy 上 函数 ， 最 好 再 定义 一 个 顶层 函数 。 这 个 函 数 直接 写 在 Laterkt 文 件 中 就 可 以 
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了 , 但 是 要 定义 在 Later 类 的 外 面 ， 因为 只 有 不 定义 在 任何 类 当中 的 函数 才 是 顶层 函数 。 代 码 
如 下 所 示 : 


fun <T> later(block: () -> T) = Later(block) 


我 们 将 这 个 顶层 函数 也 定义 成 了 泛 型 函数 ， 并 且 它 也 接收 一 个 函数 类 型 参数 。 这 个 顶层 函数 的 
作用 很 简单 : 创建 Later 类 的 实例 ， 并 将 接收 的 削 数 类 型 参数 传 给 Later 类 的 构造 溺 数 。 


现在 ， 我 们 自己 编写 的 Later 懒 加 载 函 数 就 已 经 完成 了 ， 你 可 以 直接 使 用 它 来 蔡 代 之 前 的 Lazy 
吸 数 ， 如 下 所 示 : 


val uriMatcher by Later { 
val matcher = UriMatcher(UriMatcher.NO MATCH) 
matcher.addURI(authority, "book", bookDir) 
matcher.addURI(authority, "book/#", bookItem) 
matcher.addURI(authority, "category", categoryDir) 
matcher.addURI(authority, "category/#", categoryItem) 
matcher 


但 是 如 何 才 能 验证 Later 医 数 的 懒 加 载 功能 有 没有 生效 呢 ? 这 里 我 有 一 个 非常 简单 方便 的 验证 
方法 , 写法 如 下 : 


val p by Later { 
Log.d("TAG", "run codes inside later block") 
"test later" 


} 


可 以 看 到 ， 我 们 在 Later 纯 数 的 代码 块 中 打印 了 一 行 日 志 。 将 这 段 代 码 放 到 任何 一 个 Activity 
中 ， 并 在 按钮 的 点 击 事件 里 调用 p 属 性 。 


你 会 发 现 ， Later 上 函 数 中 的 那 行 日 志 是 不 会 打印 的 。 只 有 当 你 首次 点 击 
按钮 的 时 候 ， 日 志 才 会 打印 出 来 ， 说 明代 码 块 中 的 代码 成 功 执行 了 。 而 当 你 再 次 点 击 按钮 的 时 
候 ， 日 志 也 不 人 因为 代码 块 中 的 代码 只 会 执行 一 次 。 


通过 这 种 方式 就 可 以 验证 懒 加 载 功 能 到 底 有 没有 生效 了 ， 你 可 以 自己 测试 一 下 。 


另外 ， 必 须 说 明 的 是 ， 虽然 我 们 编写 了 一 个 自己 的 懒 加 载 子 数 ， 但 由 于 简单 起 见 ， 这 里 只 是 大 
致 还 原 了 lazy 水 数 的 基本 实现 原理 ， 在 一 些 诸如 同步 、 空 值 处 理 等 方面 并 没有 实现 得 很 严谨 。 
因此 ， 在 正式 的 项 目 中 ,使 用 Kotlin 内 置 的 Lazy 上 疯 数 才 是 最 佳 的 选择 。 


好 了 ，, 这 节 Kotlin 课 堂 的 内 容 就 到 这 里 ， 下 面 就 让 我 们 对 本 章 所 学 的 所 有 知识 做 个 回顾 吧 。 
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8.6 小 结 与 反 评 


本 章 的 内 容 不 算 多 ， 而 且 很 多 时 候 是 在 使 用 上 一 章 中 学 习 的 数据 库 知 识 ， 所 以 理解 这 部 分 内 容 
对 你 来 说 应 该 是 比较 轻松 的 吧 。 在 本 章 中 ， 我 们 一 开始 先 了 解 了 Android 的 权限 机 制 ， 并 且 学 会 
了 如 何在 Android 6.0 以 上 的 系统 中 使 用 运行 时 权限 ， 然 后 重点 学 习 了 ContentProvider 的 相关 
内 容 ， 以 实现 跨 程序 数据 共享 的 功能 。 现 在 你 不 仅 知道 了 如 何 访问 其 他 程序 中 的 数据 ， 还 学 会 
了 怎样 创建 自己 的 ContentProvider 来 共享 数据 , 收获 还 是 挺 大 的 吧 。 


不 过 , 每 次 在 创建 ContentProvider 的 时 候 ， 你 都 需要 提醒 一 下 自己 ， 我 是 不 是 应 该 这 么 做 ? 
因为 只 有 在 真正 需要 将 数据 共享 出 去 的 时 候 才 应 该 创建 ContentProvider ,如 果 仅 仅 是 用 于 程 
序 内 部 访问 的 数据 ， 就 没有 必要 这 么 做 ， 所 以 干 万 别 对 它 进行 滥用。 

本 章 的 Kotlin 课 堂 又 是 干货 满 满 的 一 堂 课 啊 。 我 们 学 习 了 泛 型 和 委托 这 两 块 主题 内 容 ， 虽然 难度 
是 在 渐渐 增加 的 ， 但 是 这 些 都 是 Kotlin 中 非常 重要 的 功能 ， 你 可 干 万 不 能 掉队 。 尤 其 是 泛 型 功 
能 ， 在 后 面 的 章节 里 还 会 频繁 用 到 ， 一 定 要 好 好 掌握 才 行 。 


在 连续 学 了 几 章 系统 机 制 方面 的 内 容 之 后 ， 是 不 是 感觉 有 些 枯燥 ?那么 下 一 章 中 我 们 就 换 换 口 
味 ,学习 一 下 Android 多 媒体 方面 的 知识 吧 。 
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第 9 章 丰富 你 的 程序 , 运用 手机 多 媒体 


在 很 早 以 前 ， 手 机 的 功能 普遍 比较 单调 ， 仅 仅 就 是 用 来 打 电 话 和 发 短信 的 。 而 如 今 ， 手 机 在 我 
们 的 生活 中 正 扮演 着 越 来 越 重 要 的 角色 ， 各 种 娱乐 活动 都 可 以 在 手机 上 进行 : 上 班 的 路 上 太 无 
聊 ,可 以 戴 着 耳机 听 音 乐 ; 外 出 旅行 的 时 候 ， 可 以 在 手机 上 看 电影 ; 无 论 走 到 哪里 ， 遇 到 喜欢 
的 事物 都 可 以 用 于 机 拍 下 来 。 


手机 上 众多 的 娱乐 方式 少不了 强大 的 多 媒体 功能 的 支持 ， 而 Android 在 这 方面 做 得 非常 出 色 。 它 
提供 了 一 系列 的 API ,使 得 我 们 可 以 在 程序 中 调用 很 多 手机 的 多 媒体 资源 ， 从 而 编写 出 更 加 丰 高 
多 彩 的 应 用 程序 。 本 章 我 们 就 将 学 习 Android 中 一 些 常用 的 多 媒体 功能 的 使 用 技巧 。 


在 前 8 章 中 ， 我 们 一 直 是 使 用 模拟 器 来 运行 程序 的 ， 不 过 本 章 涉及 的 一 些 功 能 必须 要 在 真正 的 


Android 手 机 上 运行 才 看 得 到 | 效果。 因此 ,我 们 就 先 来 学 习 一 下 如 何 使 用 Android 手 机 运行 程 
序 。 
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9.1 将 程序 运行 到 手机 上 


不 必 我 多 说 ， 首 先 你 需要 拥有 一 部 Android 手 机 。 现 在 Android 手 机 早 就 不 是 什么 稀罕 物 ， 几 乎 
已 经 是 人 手 一 部 了 ， 如 果 你 还 没有 的 话 ， 赶 紧 去 购买 吧 。 


想 要 将 程序 运行 到 于 机 上 “， 我们 需要 先 通过 数据 线 把 手机 连接 到 电脑 上 。 然 后 进入 设置 -系统 ~ 
开发 者 选项 界面 ， 并 在 这 个 界面 中 选中 USB 调 试 选项 ， 如 图 9.1 所 示 。 


8:31 | 


《 开发 者 选项 


USB 调试 @ 


连接 USB 后 启用 调试 模式 
撤消 USB 调试 授权 


错误 报告 快捷 方式 
在 电源 菜单 中 显示 用 于 提交 错误 报告 的 按 


读 


选择 模拟 位 置信 息 应 用 


强制 启用 GNSS 测量 结果 全 面 跟踪 
在 停 用 工作 周期 的 情况 下 跟踪 所 有 GNSS 
星座 和 频率 


启用 视图 属性 检查 功能 


选择 调试 应 用 


未 设置 任何 调试 应 用 
© 加 


图 9.1 启用 USB 调 试 


注意 ,从 Android 4.2 系 统 开始 ， 开 发 者 选项 默认 是 隐藏 的 ， 你 需要 先进 入 “关于 于 机 "界面 ， 然 
后 对 着 最 下 面 的 版 本 号 那 一 栏 连续 点 击 ， 就 会 让 开发 者 选项 显示 出 来 。 
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如 果 你 使 用 的 是 Windows 操 作 系统 ， 可 能 还 需要 在 电脑 上 安装 手机 的 驱动 。 一 般 借助 360 手 机 
助手 或 驶 豆 荧 等 工具 就 可 以 快速 进行 安装 ， 安 装 完成 后 手机 就 可 以 连接 到 电脑 上 了 。 


另外 ， 如果 这 是 你 首次 使 用 这 部 手机 连接 电脑 的 话 ， 手 机 上 应 该 还 会 出 现 一 个 如 图 9.2 所 示 的 弹 
窗 提示 。 


允许 USB 调试 吗 ? 

这 人 台 计 算 机 的 RSA 密 钥 指纹 如 下 : 
E1:D6:5C:95:B1:14:40:53:29:08:71:F6:6D: 
7F:AF:D8 


中 一 律 允 许 使 用 这 台 计 算 机 进行 调试 


图 9.2 ”人 允许 USB 调 试 的 弹 窗 提示 


勾 选 “一 律 允 许 使 用 这 台 计 算 机 进行 调试 ”的 选项 ,然后 点 击 “ 人 允许 ”, 这 样 下 次 连接 电脑 的 时 候 
就 不 会 再 弹出 这 个 提示 了 。 


现在 观察 Logcat， 你 会 发 现 当前 是 有 两 个 设备 在 线 的 ， 一 个 是 我 们 一 直 使 用 的 模拟 器 ， 另 外 一 
个 则 是 刚刚 连接 上 的 手机 ， 如 图 9.3 所 示 。 
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国 Emulator Pixel_API_29 Android 1 v com.examp 
而 Emulator Pixel_API_29 Android 10, API 29 


Google Pixel Android 10, API 29 


图 9.3 在线 设备 列表 


然后 观察 Android Studio 顶 部 的 工具 栏 , 我 们 可 以 在 这 里 选择 将 当前 项 目 运行 到 哪 台 设备 上 ， 
如 图 9.4 所 示 。 


i app 地 D。 Google Pixel 了 | BP 着 
Running devices 
[Pixel API 29 
LJ, Google Pixel 
Available devices 


Lu Pixel C API 29 


PP Run on multiple devices 
忆 Open AVD Manager 


Troubleshoot device connections 


图 9.4 ”选择 当前 项 目的 运行 设备 
选中 “Google Pixel” 这 台 设 备 ， 就 可 以 使 用 真实 的 手机 来 运行 程序 了 。 
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9.2 使 用 通知 


通知 (notification) 是 Android 系 统 中 比较 有 特色 的 一 个 功能 ， 当 某 个 应 用 程序 希望 向 用 户 发 
出 一 些 提示 信息 ， 而 该 应 用 程序 又 不 在 前 台 运 行 时 ， 就 可 以 借助 通知 来 实现 。 发 出 一 条 通知 
后 ， 手 机 最 上 方 的 状态 栏 中 会 显示 一 个 通知 的 图 标 ， 下 拉 状态 栏 后 可 以 看 到 通知 的 详细 内 容 。 
Android 的 通知 功能 自 推出 以 来 就 大 获 成 功 ， 连 iOS 系 统 也 在 5.0 版 本 之 后 加 入 了 类 似 的 功能 。 


9.2.1 创建 通知 渠道 
然而 ， 通 知 这 个 功能 的 设计 初衷 是 好 的 ， 后 来 却 被 开发 者 给 玩 坏 了 。 


每 发 出 一 条 通知 ， 都 可 能 意味 着 自己 的 应 用 程序 会 拥有 更 高 的 打开 率 ， 因 此 有 太 多 太 多 的 应 用 
会 想 尽 办 法 地 给 用 户 发 送 通知 ,以 博取 更 多 的 展示 机 会 。 站 在 应 用 自身 的 角度 来 看 ， 这 人 么 做 或 
许 并 没有 什么 错 ; 但 是 站 在 用 户 的 角度 来 看 ， 如 果 每 一 个 应 用 程序 都 这 么 做 的 话 ， 那 么 用 户 手 
机 的 状态 栏 就 会 被 各 式 各 样 的 通知 信息 堆 满 ， 不 胜 其 烦 。 


虽然 Android 系 统 人 允许 我 们 将 某 个 应 用 程序 的 通知 完全 屏蔽 ， 以 防止 它 一 直 给 我 们 发 送 垃圾 信 
息 ,但 是 在 这 些 信息 中 ， 也 可 能 会 有 我 们 所 关心 的 内 容 。 比 如 说 我 希望 收 到 某 个 我 所 关注 的 人 
的 微 博 更 新 通知 ， 但 是 却 不 想 让 微 博 一 天 到 | 晚 给 我 推送 一 些 明 星 的 花边 新 闻 。 在 过 去 ， 用 户 是 
没有 办 法 对 这 些 信息 做 区 分 的 ， 要 么 同意 接受 所 有 信息 ， 要么 屏 沼 所 有 信息 , 这 也 是 Android 通 
知 功 能 的 痛 点 。 


于 是 , Android 8.0 系 统 引 入 了 通知 渠道 这 个 概念 。 


什么 是 通知 渠道 呢 ? 顾名思义 ， 就 是 每 条 通知 都 要 属于 一 个 对 应 的 渠道 。 每 个 应 用 程序 都 可 以 
自由 地 创建 当前 应 用 拥有 哪些 通知 渠道 ， 但 是 这 些 通知 渠道 的 控制 权 是 掌握 在 用 户 手 上 的 。 用 
户 可 以 自由 地 选择 这 些 通知 渠道 的 重要 程度 ， 是否 响 铃 、 是 否 振动 或 者 是 否 要 关闭 这 个 渠道 的 
通知 。 


拥有 了 这 些 控制 权 之 后 ， 用 户 就 再 也 不 用 害怕 那些 垃圾 通知 的 打扰 了 “， 因 为 用 户 可 以 自主 地 选 
择 关 心 哪些 通知 、 不 关心 哪些 通知 。 以 刚才 的 场景 举例 ， 微 博 就 可 以 创建 两 种 通知 渠道 ， 一 个 
关注 ， 一 个 推荐 。 而 我 作为 用 户 ， 如 果 对 推荐 类 的 通知 不 感 兴趣 ， 那 么 我 就 可 以 直接 将 推荐 通 
知 渠道 关闭 ， 这 样 既 不 影响 我 接收 关心 的 通知 ， 又 不 会 让 那些 我 不 关心 的 通知 来 打 执 我 了 。 

对 于 每 个 应 用 来 说 ， 通 知 渠 道 的 划分 是 非常 考究 的 ， 因 为 通知 渠道 一 旦 创建 之 后 就 不 能 再 修改 
了 ， 因 此 开发 者 需要 仔细 分 析 自己 的 应 用 程序 一 共有 哪些 类 型 的 通知 ,然后 再 去 创建 相应 的 通 
知 渠道 。 这 里 我 们 参考 一 下 Twitter 的 通知 渠道 划分 ， 如 图 9.5 所 示 。 
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和 设置 Qa © 


© 


Twitter 


@SINYU890807 


显示 通知 


紧急 警报 
与 你 和 你 的 推 文 有 关 
新 闻 


关注 者 和 联系 人 


每 周 大 约 1 条 通知 


来 自 Twitter 的 推荐 


a 多 图 


图 9.5 Twitter 的 通知 渠道 的 划分 


可 以 看 到 ，Twitter 根 据 自 己 的 通知 类 型 ， 对 通知 渠道 进行 了 非常 详细 的 划分 。 这 样 用 户 的 自主 
选择 性 就 比较 高 了 ， 也 就 大 大 降低 了 用 户 因 不 堪 其 垃圾 通知 的 驭 扰 而 将 应 用 程序 卸载 的 概率 。 


而 我 们 的 应 用 程序 如 果 想 要 发 出 通知 ， 也 必须 创建 自己 的 通知 渠道 才 行 ， 下 面 我 们 就 来 学 习 一 
下 创建 通知 渠道 的 详细 步骤 。 


首先 需要 一 个 NotificationManager 对 通知 进行 管理 ， 可 以 通过 调用 Context 的 
getSystemService() 方 法 获取 。getSystemService() 方 法 接收 一 个 字符 串 参数 用 于 确定 
获取 系统 的 哪个 服务 ， 这 里 我 们 传 入 Context .NOTIFICATION SERVICE 即 可 。 因 此， 获取 
NotificationManager 的 实例 就 可 以 写成 : 


val manager = getSystemService(Context.NOTIFICATION _ SERVICE) as NotificationManager 


www.blogss.cn 


接 下 来 要 使 用 NotificationChannetL 类 构建 一 个 通知 渠道 ， 并 调用 NotificationManager 的 
createNotificationChannel () 方 法 完成 创建 。 由 于 NotificationChannel 类 和 
createNotificationChannel () 方 法 都 是 Android 8.0 系 统 中 新 增 的 AP1, 因此 我 们 在 使 用 
的 时 候 还 需要 进行 版 本 判断 才 可 以 ， 写 法 如 下 : 


if (Build.VERSION.SDK INT >= Build.VERSION CODES.0) { 
val channel = NotificationChannel (channelId, channelName, importance) 
manager.createNotificationChannel (channel) 


创建 一 个 通知 渠道 至 少 需要 渠道 ID、 渠 道 名 称 以 及 重要 等 级 这 3 个 参数 ， 其 中 渠道 ID 可 以 随便 定 
义 ， 只 要 保证 全 局 唯一 性 就 可 以 。 渠 道 名 称 是 给 用 户 看 的 ， 需 要 可 以 清楚 地 表达 这 个 渠道 的 用 
途 。 通 知 的 重要 等 级 主要 有 IMPORTANCE HIGH、IMPORTANCE DEFAULT、 
IMPORTANCE LOW、IMPORTANCE_ MIN 这 几 种 ,对 应 的 重要 程度 依次 从 高 到 低 。 不 同 的 重要 等 
级 会 决定 通知 的 不 同行 为 ， 后 面 我 们 会 通过 具体 的 例子 进行 演示 。 当 然 这 里 只 是 初始 状态 下 的 
重要 等 级 ， 用户 可 以 随时 手动 更 改 某 个 通知 渠道 的 重要 等 级 ， 开 发 者 是 无 法 干预 的 。 


9.2.2 通知 的 基本 用 法 


了 解 了 如 何 创建 通知 渠道 之 后 ， 下面 我 们 就 来 看 一 下 通知 的 使 用 方法 吧 。 通 知 的 用 法 还 是 比较 
灵活 的 ， 既 可 以 在 Activity 里 创建 ， 也 可 以 在 BroadcastReceiver 里 创建 ， 当然 还 可 以 在 后 面 
我 们 即将 学 习 的 Service 里 创建 。 相 比 于 BroadcastReceiver 和 Service , 在 Activity 里 创建 通 
知 的 场景 还 是 比较 少 的 ， 因 为 一 般 只 有 当 程 序 进入 后 台 的 时 候 才 需要 使 用 通知 。 


不 过 ， 无 论 是 在 哪里 创建 通知 ， 整 体 的 步 又 都 是 相同 的 ， 下 面 我 们 就 来 学 习 一 下 创建 通知 的 详 
细 步 又 。 


首先 需要 使 用 一 个 Builder 构 造 器 来 创建 Notification 对 象 ， 但 问题 在 于 , Android 系 统 的 每 
一 个 版 本 都 会 对 通知 功能 进行 或 多 或 少 的 修改 ，API 不 稳定 的 问题 在 通知 上 凸显 得 尤其 严重 , 比 
方 说 刚刚 介绍 的 通知 渠道 功能 在 Android 8.0 系 统 之 前 就 是 没有 的 。 那 么 该 如 何 解 决 这 个 问题 
呢 ? 其 实 解决 方案 我 们 之 前 已 经 见 过 好 几 回 了 ， 就 是 使 用 AndroidX 库 中 提供 的 兼容 API。 
AndroidX 库 中 提供 了 一 个 NotificationCompat 类 ，, 使 用 这 个 类 的 构造 器 创建 
Notification 对 象 ,就 可 以 保证 我 们 的 程序 在 所 有 Android 系 统 版 本 上 都 能 正常 工作 了 ， 代 
码 如 下 所 示 : 


val notification = NotificationCompat.Builder(context, channelId).build() 


NotificationCompat .Builder 的 构造 痕 数 中 接收 两 个 参数 : 第 一 个 参数 是 context , 这 个 
没什么 好 说 的 ; 第 二 个 参数 是 渠道 ID ， 需 要 和 我 们 在 创建 通知 渠道 时 指定 的 渠道 ID 相 匹 配 才 
行 。 

当然 ， 上述 代 码 只 是 创建 了 一 个 空 的 Notification 对 象 ， 并 没有 什么 实际 作用 ， 我们 可 以 在 


最 终 的 build() 方 法 之 前 连 缀 任意 多 的 设置 方法 来 创建 一 个 丰富 的 Notification 对 象 ， 先 来 
看 一 些 最 基本 的 设置 : 


val notification = NotificationCompat.Builder(context, channelId) 
.SetContentTitle("This is content title") 
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.SetContentText("This is content text") 

.SetSmallIcon(R.drawable.small icon) 
.SetLargelcon(BitmapFactory.decodeResource(getResources(),R.drawable.large icon)) 
.build() 


上 述 代 码 中 一 共 调 用 了 4 个 设置 方法 ， 下面 我 们 来 一 一 解析 一 下 。setContentTitle() 方 法 用 
于 指定 通知 的 标题 内 容 ， 下 拉 系 统 状态 栏 就 可 以 看 到 这 部 分 内 容 。setContentText ( ) 方 法 用 
于 指定 通知 的 正文 内 容 ， 同 样 下 拉 系统 状态 栏 就 可 以 看 到 这 部 分 内 容 。setSmaLLIcon( ) 方 法 
用 于 设置 通知 的 小 图 标 , 注意， 只 能 使 用 纯 alpha 图 层 的 图 片 进行 设置 ， 小 图 标 会 显示 在 系统 状 
态 栏 上 。setLargeIcon ( ) 方 法 用 于 设置 通知 的 大 图 标 ， 当 下 拉 系 统 状 态 栏 时 ， 就 可 以 看 到 设 
置 的 大 图 标 了 。 


以 上 工作 都 完成 之 后 ， 只 需要 调用 NotificationManager 的 notify () 方 法 就 可 以 让 通知 显示 

出 来 了 。notify() 方 法 接收 两 个 参数 : 第 一 个 参数 是 id， 要 保证 为 每 个 通知 指定 的 id 都 是 不 
同 的 ; 第 二 个 参数 则 是 Notification 对 象 , 这 里 直接 将 我 们 刚刚 创建 好 的 Notification 对 
象 传 入 即 可 。 因 此 ， 显示 一 个 通知 就 可 以 写成 : 


manager.notify(1, notification) 


到 这 里 就 已 经 把 创建 通知 的 每 一 个 步骤 都 分 析 完 了 ， 下 面 就 让 我 们 通过 一 个 具体 的 例子 来 看 一 
看 通知 到 底 是 长 什么 样 的 。 


新 建 一 个 NotificationTest 项 目 ， 并 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/sendNotice" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:text="Send Notice" /> 


</LinearLayout> 


布局 文件 非常 简单 ， 里 面 只 有 一 个 “Send Notice” 按 钮 ,用 于 发 出 一 条 通知 。 接 下 来 修改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val manager = getSystemService(Context.NOTIFICATION SERVICE) as 


NotificationManager 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.0) { 
val channel = NotificationChannel("normal", "Normal",NotificationManager. 


IMPORTANCE DEFAULT) 
manager.createNotificationChannel (channel) 


sendNotice.setOnClickListener { 
val notification = NotificationCompat.Builder(this, "normal") 
.SetContentTitle("This is content title") 
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.SetContentText("This is content text") 
.SetSmallIlcon(R.drawable.small icon) 
.SetLargelcon(BitmapFactory.decodeResource(resources, 
R.drawable. large icon)) 
.build() 
manager.notify(1, notification) 


} 
可 以 看 到 ， 我 们 首先 获取 了 NotificationManager 的 实例 ， 并 创建 了 一 个 ID 为 normal 通 知 渠 


统 和 人 人 


道 。 创 建 通 知 渠 道 的 代码 只 在 第 一 次 执行 的 时 候 才 会 创建 ， 当 下 次 再 执行 创建 代码 时 ， 系统 会 
检测 到 该 通知 渠道 已 经 存在 了 ， 因 此 不 会 重复 创建 ， 也 并 不 会 影响 运行 效率 。 

接 下 来 在 “Send Notice” 按 钮 的 点 击 事件 里 完成 了 通知 的 创建 工作 ， 创建 的 过 程 正如 前 面 所 描 
述 的 一 样 。 注 意 ,在 NotificationCompat ,Buitder 的 构造 盟 数 中 传 入 的 渠道 ID 也 必须 叫 
normal , 如 果 传 入 了 一 个 不 存在 的 渠道 ID ， 通 知 是 无 法 显示 出 来 的 。 另 外 ,通知 上 显示 的 图 标 
你 可 以 使 用 自己 准备 的 图 片 ， 也 可 以 使 用 随 书 源码 附带 的 图 片 资源 (源码 下 载 地 址 见 前 言 ) 

新 建 一 个 drawable-xxhdpi 目 录 ， 将 图 片 放 入 即 可 。 

现在 可 以 来 运行 一 下 程序 了 ， 其实 MainActivity 一 旦 打开 之 后 ,通知 渠道 就 已 经 创建 成 功 了 ， 
我 们 可 以 进入 应 用 程序 设置 当中 查看 。 依 次 点 击 设置 应 用 和 通知 ”>NotificationTest 一 通知 ， 
如 图 9.6 所 示 。 
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NotificationTest 


显示 通知 


Normal 
0 每 天 大 约 1 条 通知 元 
高 级 
允许 使 用 通知 圆 点 、 气 泡 
所 时 区 


图 9.6 ”创建 的 通知 渠道 
可 以 看 到 ， 这 里 已 经 出 现 了 一 个 Normal 通 知 渠道 ， 就 是 我 们 刚刚 创建 的 。 


接 下 来 回 到 NotificationTest 程 序 当 中 ， 然 后 点 击 “Send Notice”" 按 钮 ,你 会 在 系统 状态 栏 的 最 
左边 看 到 一 个 小 图 标 ， 如 图 9.7 所 示 。 
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8:41 得 > 


NotificationTest 


SEND NOTICE 


图 9.7 通知 的 小 图 标 


下 拉 系统 状态 栏 可 以 看 到 该 通知 的 详细 信息 ， 如 图 9.8 所 示 。 
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嘱 ! NotificationTest* 现在 


This is content title 
This is content text 


图 9.8 ”通知 的 详细 信息 


如 果 你 使 用 过 Android 手 机 ， 此 时 应 该 会 下 意识 地 认为 这 条 通知 是 可 以 点 击 的 。 但 是 当 你 去 点 击 
它 的 时 候 ， 会 发 现 没有 任何 效果 。 不 对 啊 ， 每 条 通知 被 点 击 之 后 都 应 该 有 所 反应 呀 。 其 实 要 想 
实现 通知 的 点 击 效果 ， 我 们 还 需要 在 代码 中 进行 相应 的 设置 ， 这 就 涉及 了 一 个 新 的 概念 一 一 
Pendinglntent。 


Pendinglntent 从 名 字 上 看 起 来 就 和 Intent 有 些 类 似 ，, 它们 确实 存在 不 少 共同 点 。 比 如 它们 都 可 
以 指明 某 一 个 “意图 ”, 都 可 以 用 于 启动 Activity、 启 动 Service 以 及 发 送 广播 等 。 不 同 的 是 ， 
Intent 人 倾向 于 立即 执行 某 个 动作 ,而 Pendinglntent 人 项 向 于 在 某 个 合适 的 时 机 执行 某 个 动作 。 所 
以 ,也 可 以 把 Pendinglntent 简 单 地 理解 为 延迟 执行 的 Intent。 


Pendinglntent 的 用 法 同样 很 简单 ， 它 主要 提供 了 几 个 静态 方法 用 于 获取 Pendinglntent 的 实 
例 ， 可 以 根据 需求 来 选择 是 使 用 getActivity() 方 法 、getBroadcast() 方 法 , 还 是 
getService() 方 法 。 这 几 个 方法 所 接收 的 参数 都 是 相同 的 : 第 一 个 参数 依旧 是 Context ,不 
用 多 做 解释 ; 第 二 个 参数 一 般 用 不 到 , 传 入 0 即 可 ; 第 三 个 参数 是 一 个 Intent 对 象 ， 我 们 可 以 通 
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过 这 个 对 象 构建 出 Pendinglntent 的 “意图 ”; 第 四 个 参数 用 于 确定 Pendinglntent 的 行为 ,有 
FLAG ONE SHOT、 FLAG NO CREATE、FLAG CANCEL CURRENT 和 
FLAG_UPDATE_CURRENT 这 4 种 值 可 选 ， 每 种 值 的 具体 含义 你 可 以 查看 文档 ,通常 情况 下 这 个 
参数 传 入 0 就 可 以 了 。 


对 Pendinglntent 有 了 一 定 的 了 解 后 ， 我 们 再 回 过 头 来 看 一 下 
NotificationCompat.BuiLder。 这 个 构造 器 还 可 以 连 缀 一 个 setContentIntent ( ) 方 
法 ， 接 收 的 参数 正 是 一 个 Pendinglntent 对 象 。 因 此 ,这 里 就 可 以 通过 Pendinglntent 构 建 一 个 
延 人 执行 的 “意图 ”, 当 用 户 点 击 这 条 通知 时 就 会 执行 相应 的 逻辑 。 


现在 我 们 来 优化 一 下 NotificationTest 项 目 ， 给 刚才 的 通知 加 上 点 击 功 能 ， 让 用 户 点 击 它 的 时 候 
可 以 局 动 另 一 个 Activity。 


首先 需要 准备 好 另 一 个 Activity , 右 击 com.example.notificationtest 包 
New—Activity=Empty Activity , 新建 NotificationActivity。 然 后 修改 
activity_notification.Xxml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" > 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:textSize="24sp" 
android:text="This is notification layout" 
/> 


</RelativeLayout> 


这 样 就 把 NotificationActivity 准 备 好 了 ， 下面 我 们 修改 MainActivity 中 的 代码 ， 给 通知 加 入 点 
击 功能 ,如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


sendNotice.setOnClickListener { 

val intent = Intent(this, NotificationActivity::class.java) 

val pi = PendingIntent.getActivity(this, 0, intent, 0) 

val notification = NotificationCompat.Builder(this, "normal") 
.SetContentTitle("This is content title") 
.SetContentText("This is content text") 
.SetSmallIcon(R.drawable.small icon) 
.SetLargelcon(BitmapFactory.decodeResource(resources, 

R.drawable. large icon)) 

.SetContentIntent (pi) 
.build() 

manager.notify(1, notification) 
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可 以 看 到 ,这 里 先是 使 用 Intent 表 达 出 我 们 想 要 局 动 NotificationActivity 的 “意图 ”, 然后 将 构 
建 好 的 Intent 对 象 传 入 Pendinglntent 的 getActivity() 方 法 里 ,以 得 到 Pendinglntent 的 实 
例 ,接着 在 NotificationCompat.BuiLder 中 调用 setContentIntent () 方 法 ,把 它 作为 


参数 传 入 即 可 。 


现在 重新 运行 一 下 程序 , 并 点 击 “Send Notice” 按 钮 ， 依旧 会 发 出 一 条 通知 。 然 后 下 拉 系 统 状 
态 栏 , 点 击 一 下 该 通知 ,就 会 打开 NotificationActivity 的 界面 了 ， 如 图 9.9 所 示 。 


8:57 哪 | 


NotificationTest 


This is notification layout 


图 9.9 ”点 击 通 知 后 打开 NotificationActivity 界 面 

呈 ? 怎么 系统 状态 上 的 通知 图 标 还 没有 消失 呢 ? 是 这 样 的 ， 如 果 我 们 没有 在 代码 中 对 该 通知 进 
行 取消 , 它 就 会 一 直 显 示 在 系统 的 状态 栏 上 。 解 决 的 方法 有 两 种 : 一 种 是 在 
NotificationCompat .Builder 中 再 连 弘一 个 setAutoCancel() 方 法 ,一 种 是 显 式 地 调用 
NotificationManager 的 cancel ( ) 方 法 将 它 取消 。 两 种 方法 我 们 都 学 习 一 下 。 


第 一 种 方法 写法 如 下 : 
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val notification = NotificationCompat.Builder(this, "normal") 


.SetAutoCancel (true) 
.build() 


可 以 看 到 ,setAutoCancel() 方 法 传 入 true , 就 表示 当 点 击 这 个 通知 的 时 候 ， 通 知 会 自动 取 
消 。 


第 二 种 方法 写法 如 下 : 


class NotificationActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity notification) 
val manager = getSystemService(Context.NOTIFICATION SERVICE) as 
NotificationManager 
manager.cancel(1) 


} 


这 里 我 们 在 cancel ( ) 方 法 中 传 入 了 1 ，, 这 个 1 是 什么 意思 呢 ? 还 记得 在 创建 通知 的 时 候 给 每 条 
通知 指定 的 id 吗 ? 当时 我 们 给 这 条 通知 设置 的 id 就 是 1。 因 此 ， 如果 你 想 取 消 哪 条 通知 ,在 
cancel() 方 法 中 传 入 该 通知 的 id 就 行 了 。 


9.2.3 通知 的 进 阶 技巧 


现在 你 已 经 掌握 了 创建 和 取消 通知 的 方法 ， 并 且 知 道 了 如 何 去 响 应 通知 的 点 击 事件 。 不 过 通知 
的 用 法 并 不 仅仅 是 这 些 呢 ， 下 面 我 们 就 来 探究 一 下 通知 的 更 多 技巧 。 


上 一 小 节 中 创建 的 通知 属于 最 基本 的 通知 , 实际 上 ,NotificationCompat .Builder 中 提供 
了 非常 丰富 的 APl， 以 便 我 们 创建 出 更 加 多 样 的 通知 效果 。 当 然 ， 每 一 个 API 都 详细 地 讲 一 遍 不 
太 可 能 ,我们 只 能 从 中 选 一 些 比 较 常用 的 API 进 行 学 习 。 


先 来 看 看 setStyle() 方 法 ,这 个 方法 允许 我 们 构建 出 语文 本 的 通知 内 容 。 也 就 是 说 ， 通知 中 
不 光 可 以 有 文字 和 图 标 ， 还 可 以 包含 更 多 的 东西 。setStyle( ) 方 法 接收 一 个 
NotificationCompat ,StyLe 参 数 ， 这 个 参数 就 是 用 来 构建 具体 的 富 文本 信息 的 ， 如 长 文 
字 、 图 片 等 。 


在 开始 使 用 setStyle() 方 法 之 前 ， 我 们 先 来 做 一 个 试验 吧 , 之 前 的 通知 内 容 都 比较 短 ， 如 果 
设置 成 很 长 的 文字 会 是 什么 效果 呢 ? 比如 这 样 写 : 


val notification = NotificationCompat.Builder(this, "normal") 
.SetContentText("Learn how to build notifications, send and sync data, 
and use voice actions.Get the official Android IDE and developer tools to 
build apps for Android.") 


.buitd() 


现在 重新 运行 程序 并 触发 通知 ,效果 如 图 9.10 所 示 。 
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过 目 2 天 12 小 时 


筑 NotificationTest ' 现在 


This is content title 
Learn how to build notifications, send and sync … 


图 9.10 ”通知 内 容 文字 过 长 的 效果 


可 以 看 到 ， 通 知 内 容 是 无 法 完整 显示 的 ， 多 余 的 部 分 会 用 省 略 号 代替 。 其 实 这 也 很 正常 ， 因 为 
通知 的 内 容 本 来 就 应 该 言 简 意 凡 ， 详 细 内 容 放 到 点 击 后 打开 的 Activity 当 中 会 更 加 合适 。 


但 是 如 果 你 真 的 非常 需要 在 通知 当中 显示 一 段 长 文字 , Android 也 是 支持 的 ， 通 过 setStytLe() 
方法 就 可 以 做 到 ,具体 写法 如 下 : 


val notification = NotificationCompat.Builder(this, "normal") 


.SetStyle(NotificationCompat.BigTextStyle().bigText("Learn how to build 
notifications, send and sync data, and use voice actions. Get the official 
Android IDE and developer tools to build apps for Android.")) 


.build() 
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这 里 使 用 了 setStyle( ) 方 法 替代 setContentText() 方 法 。 在 setStyle() 方 法 中 ,我 们 创 
建 了 一 个 NotificationCompat ,BigTextStyLe 对 象 , 这 个 对 象 就 是 用 于 封装 长 文字 信息 
的 ， 只 要 调用 它 的 bigText ( ) 方 法 并 将 文字 内 容 传 入 就 可 以 了 。 


再 次 重新 运行 程序 并 触发 通知 ， 效果 如 图 9.11 所 示 。 


% 自 2 天 11 小 时 


叫 ! NotificationTest* 现在 党 


This is content title 

Learn how to build notifications, send and sync ms 
data, and use voice actions. Get the official 

Android IDE and developer tools to build apps for Android. 


图 9.11 通知 中 显示 长 文字 的 效果 
除了 显示 长 文字 之 外 ， 通 知 里 还 可 以 显示 一 张大 图 片 , 具体 用 法 是 基本 相似 的 : 


val notification = NotificationCompat.Builder(this, "normal") 


.SetStyle(NotificationCompat.BigPictureStyle().bigPicture( 
BitmapFactory.decodeResource(resources, R.drawable.big image))) 


.build() 
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可 以 看 到 ， 这 里 仍然 是 调用 的 setStytLe( ) 方 法 ,这 次 我 们 在 参数 中 创建 了 一 个 
NotificationCompat.BigPictureStyLe 对 象 , 这 个 对 象 就 是 用 于 设置 大 图 片 的 ， 然 后 调 
用 它 的 bigPicture() 方 法 并 将 图 片 传 入 。 这 里 我 事先 准备 好 了 一 张 图 片 ， 通过 
BitmapFactory 的 decodeResource() 方 法 将 图 片 解 析 成 Bitmap 对 象 ， 再 传 入 
bigPicture() 方 法 中 就 可 以 了 。 


现在 重新 运行 一 下 程序 并 触发 通知 ， 效 果 如 图 9.12 所 示 。 


叫 ! NotificationTest ' 现在 全 


This is content title 


图 9.12 通知 中 显示 大 图 片 的 效果 
这 样 我 们 就 把 setStyle( ) 方 法 中 的 重要 内 容 基本 掌握 了 。 


接 下 来 ， 我 们 学 习 一 下 不 同 重 要 等 级 的 通知 渠道 对 通知 的 行为 具体 有 什么 影响 。 其 实 简单 来 
讲 ， 就 是 通知 渠道 的 重要 等 级 越 高 ,发 出 的 通知 就 越 容 易 获得 用 户 的 注意 。 比 如 高 重要 等 级 的 
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通知 渠道 发 出 的 通知 可 以 弹出 横幅 、 发 出 声音 ， 而 低 重 要 等 级 的 通知 渠道 发 出 的 通知 不 仅 可 能 
会 在 某 些 情况 下 被 隐藏 , 而 且 可 能 会 被 改变 显示 的 顺序 ， 将 其 排 在 更 重要 的 通知 之 后 。 


但 需要 注意 的 是 ， 开 发 者 只 能 在 创建 通知 渠道 的 时 候 为 它 指定 初始 的 重要 等 级 ， 如 果 用 户 不 认 
可 这 个 重要 等 级 的 话 ， 可 以 随时 进行 修改 ， 开 发 者 对 此 无 权 再 进行 调整 和 变更 ， 因 为 通知 渠道 
一 旦 创建 就 不 能 再 通过 代码 修改 了 。 


既然 无 法 修改 之 前 创建 的 通知 渠道 ， 那么 我 们 就 只 好 再 创建 一 个 新 的 通知 渠道 来 测试 了 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
if (Build.VERSION.SDK INT >= Build.VERSION CODES.0) { 


val channel2 = NotificationChannel("important", "Important", 
NotificationManager.IMPORTANCE HIGH) 
manager.createNotificationChannel (channel2) 


sendNotice.setOnClickListener { 
val intent = Intent(this, NotificationActivity::class.java) 
val pi = PendingIntent.getActivity(this, 0, intent, 0) 
val notification = NotificationCompat.Builder(this, "important") 


} 


这 里 我 们 将 通知 渠道 的 重要 等 级 设置 成 了 “高 ”, 表示 这 是 一 条 非常 重要 的 通知 ， 要求 用 户 必 须 
立刻 看 到 。 现 在 重新 运行 一 下 程序 ， 并 点 击 “Send notice” 按 钮 ， 效果 如 图 9.13 所 示 。 
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各 NotificationTest 


This is content title 
Learn how to build notifications, send and sync … 


图 9.13 触发 一 条 重要 通知 

可 以 看 到 ， 这 次 的 通知 不 是 在 系统 状态 栏 显示 一 个 小 图 标 了 ， 而 是 弹出 了 一 个 横幅 ， 并 附带 了 
通知 的 详细 内 容 ， 表 示 这 是 一 条 非常 重要 的 通知 。 不 管用 户 现在 是 在 玩 游戏 还 是 看 电影 ， 这 条 
通知 都 会 显示 在 最 上 方 ， 以 此 引起 用 户 的 注意 。 当 然 ， 使 用 这 类 通知 时 一 定 要 小 心 ， 确保 你 
通知 内 容 的 确 是 至 关 重 要 的 ， 不 然 如 果 让 用 户 产 生 排斥 感 的 话 ， 可 能 会 造成 适得其反 的 效果 。 
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9.3 调用 摄像 头 和 相册 


我 们 平时 在 使 用 QQ 或 微 信 的 时 候 经 常 要 和 别人 分 享 图 片 ， 这 些 图 片 可 以 是 用 手机 摄像 头 拍 的 ， 
也 可 以 是 从 相册 中 选取 的 。 这 样 的 功能 实在 是 太 常见 了 ， 几乎 是 应 用 程序 必 备 的 功能 ， 那么 本 
节 我 们 就 学 习 一 下 调用 摄像 头 和 相册 方面 的 知识 。 


9.3.1 调用 摄像 头 拍照 


先 来 看 看 摄像 头 方面 的 知识 ， 现 在 很 多 应 用 会 要 求 用 户 上 传 一 张 图 片 作为 头像 ， 这 时 打开 摄像 
头 拍 张 照 是 最 简单 快捷 的 。 下 面 就 让 我 们 通过 一 个 例子 学 习 一 下 ， 如 何 才能 在 应 用 程序 里 调用 
于 机 的 摄像 头 进行 拍照 。 


新 建 一 个 CameraAlbumTest 项 目 ， 然 后 修改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/takePhotoBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Take Photo" /> 


<ImageView 
android:id="@+id/imageView" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" /> 


</LinearLayout> 


可 以 看 到 ,布局 文件 中 只 有 两 个 控件 : 一 个 Button 和 一 个 ImageView。Button 是 用 于 打开 摄 
像 头 进行 拍照 的 ,而 ImageView 则 是 用 于 将 拍 到 的 图 片 显 示 出 来 。 


然后 开始 编写 调用 摄像 头 的 具体 逻辑 ， 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


val takePhoto = 1 
lateinit var imageUri: Uri 
lateinit var outputImage: File 


override fun onCreate(savedInstanceState: Bundle?) { 

super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
takePhotoBtn.setOnClickListener { 

// 创建 File 对 象 ， 用 于 存储 拍照 后 的 图 片 

outputImage = File(externalCacheDir, "output image.jpg") 

if (outputImage.exists()) { 

outputImage.delete() 


outputImage.createNewFile() 
imageUri = if (Build.VERSION.SDK INT >= Build.VERSION CODES.N) { 
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FileProvider.getUriForFile(this, "com.example.cameraalbumtest. 
fileprovider", outputImage) 
} else { 
Uri.fromFile(outputImage) 


} 

// 启动 相机 程序 

val intent = Intent("android.media.action.IMAGE CAPTURE") 
intent.putExtra(MediaStore.EXTRA OUTPUT, imageUri) 
startActivityForResult(intent, takePhoto) 


} 


override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { 
super.onActivityResult(requestCode, resultCode, data) 
when (requestCode) { 
takePhoto -> { 
if (resultCode == Activity.RESULT OK) { 
// 将 拍摄 的 照片 显示 出 来 
val bitmap = BitmapFactory.decodeStream(contentResolver. 
openInputStream(imageUri)) 

imageView.setImageBitmap(rotateIlfRequired(bitmap)) 


} 


private fun rotateIfRequired(bitmap: Bitmap): Bitmap { 

val exif = ExifIinterface(outputImage.path) 

val orientation = exif.getAttributeInt (ExifInterface.TAG ORIENTATION, 
ExifIinterface.ORIENTATION NORMAL) 

return when (orientation) { 
ExifIinterface.ORIENTATION ROTATE 90 -> rotateBitmap(bitmap, 90) 
ExifIinterface.ORIENTATION ROTATE 180 -> rotateBitmap(bitmap, 180) 
ExifIinterface.ORIENTATION ROTATE 270 -> rotateBitmap(bitmap, 270) 
else -> bitmap 


} 


private fun rotateBitmap(bitmap: Bitmap, degree: Int): Bitmap { 
val matrix = Matrix() 
matrix.postRotate(degree.toFloat()) 
val rotatedBitmap = Bitmap.createBitmap(bitmap, 0, 0, bitmap.width, bitmap.height, 
matrix, true) 
bitmap.recycle() // 将 不 再 需要 的 Bitmap 对 象 回收 
return rotatedBitmap 


} 


上 述 代码 稍微 有 点 复杂 ,下面 我 们 来 仔细 地 分 析 一 下 。 在 MainActivity 中 要 做 的 第 一 件 事 自然 
是 给 Button 注 册 点 击 事件 ， 然后 在 点 击 事件 里 开始 处 理 调用 摄像 头 的 逻辑 ,我们 重点 看 一 下 这 
部 分 代码 。 


首先 这 里 创建 了 一 个 FiLe 对 象 ， 用 于 存放 摄像 头 拍 下 的 图 片 ， 这 里 我 们 把 图 片 命名 为 
output_image.jpg， 并 存放 在 手机 SD 卡 的 应 用 关联 缓存 目录 下 。 什 么 叫 作 应 用 关联 缓存 目录 
呢 ? 就 是 指 SD 卡 中 专门 用 于 存放 当前 应 用 缓存 数据 的 位 置 ， 调 用 getExternaLCacheDir() 
方法 可 以 得 到 这 个 目录 , 具体 的 路 径 是 /sdcard/Android/data/<package name>/cache。 
那么 为 什么 要 使 用 应 用 关联 缓存 目录 来 存放 图 片 呢 ? 因为 从 Android 6.0 系 统 开始 ， 读 与 SD 卡 
被 列 为 了 危险 权限 ， 如 果 将 图 片 存放 在 SD 卡 的 任何 其 他 目录 ， 都 要 进行 运行 时 权限 处 理 才 行 ， 
而 使 用 应 用 关联 目录 则 可 以 跳 过 这 一 步 。 另 外 ， 从 Android 10.0 系 统 开始 ， 公 有 的 SD 卡 目录 已 
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经 不 再 允许 被 应 用 程序 直接 访问 了 ， 而 是 要 使 用 作用 域 存 储 才 行 。 这 部 分 内 容 不 在 本 书 的 讨论 
范围 内 ， 如 果 你 有 兴趣 学 习 的 话 ， 可 以 关注 我 的 微 信 公众 号 ( 见 封面 ) ， 回 复 “作用 域 存储 " 即 
可 , 我 专门 写 了 一 篇 非常 详细 的 文章 来 讲解 这 部 分 内 容 。 


接着 会 进行 一 个 判断 ， 如 果 运 行 设备 的 系统 版 本 低 于 Android 7.0， 就 调用 Uri 的 fromFile() 
方法 将 FiLe 对 象 转换 成 Uri 对 象 ， 这 个 Uri 对 象 标识 着 output_ image.jpg 这 张 图 片 的 本 地 真实 
路 径 。 否 则 ， 就 调用 FileProvider 的 getUriForFitLe() 方 法 将 FiLe 对 象 转换 成 一 个 封装 过 的 
Uri 对 象 。getUriForFile() 方 法 接收 3 个 参数 : 第 一 个 参数 要 求 传 入 Context 对 象 ， 第 二 个 
参数 可 以 是 任意 唯一 的 字符 串 ， 第 三 个 参数 则 是 我 们 刚刚 创建 的 FiLe 对 象 。 之 所 以 要 进行 这 样 
一 层 转 换 ， 是 因为 从 Android 7.0 系 统 开始 ， 直 接 使 用 本 地 真实 路 径 的 Uri 被 认为 是 不 安全 的 ， 
会 抛 出 一 个 FileUriExposedException 异 常 。 而 FileProvider 则 是 一 种 特殊 的 
ContentProvider , 它 使 用 了 和 ContentProvider 类 似 的 机 制 来 对 数据 进行 保护 ， 可 以 选择 性 
地 将 封装 过 的 Uri 共 享 给 外 部 ， 从 而 提高 了 应 用 的 安全 性 。 


接 下 来 构建 了 一 个 Intent 对 象 ， 并 将 这 个 Intent 的 action 指 定 为 
android.media.action.IMAGE CAPTURE , 再 调用 Intent 的 putExtra() 方 法 指定 图 片 的 
输出 地 址 ， 这 里 填 入 刚刚 得 到 的 Uri 对 象 ， 最 后 调用 startActivityForResult() 启 动 
Activity。 由 于 我 们 使 用 的 是 一 个 隐 式 Intent， 系统 会 找 出 能 够 响应 这 个 Intent 的 Activity 去 局 
动 ， 这 样 照 相机 程序 就 会 被 打开 ， 拍 下 的 照片 将 会 输出 到 output image.jpg 中 。 


由 于 刚才 我 们 是 使 用 startActivityForResutLt ( ) 启动 Activity 的 ， 因 此 拍 完 照 后 会 有 结果 
返回 到 onActivityResutLt ( ) 方 法 中 。 如 果 发 现 拍 照 成 功 ， 就 可 以 调用 BitmapFactory 的 
decodeStream( ) 方 法 将 output image.jpg 这 张 照片 解析 成 Bitmap 对 象 ， 然 后 把 它 设置 到 
ImageView 中 显示 出 来 。 


需要 注意 的 是 ， 调 用 照相 机 程序 去 拍照 有 可 能 会 在 一 些 手机 上 发 生 照片 旋转 的 情况 。 这 是 因为 
这 些 手 机 认为 打开 摄像 头 进行 拍摄 时 手机 就 应 该 是 横 屏 的 ， 因 此 回 到 竖 屏 的 情况 下 就 会 发 生 90 
度 的 旋转 。 为 此 ， 这 里 我 们 又 加 上 了 判断 图 片 方向 的 代码 ， 如 果 发 现 图 片 需要 进行 旋转 ， 那 么 
就 先 将 图 片 旋转 相应 的 角度 ， 然 后 再 显示 到 界面 上 。 


不 过 现在 还 没 结束 ， 刚 才 提 到 了 ContentProvider , 那么 我 们 自然 要 在 AndroidManifest.xml 
中 对 它 进行 注册 才 行 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.cameraalbumtest"> 
<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<provider 
android:name="androidx.core.content.FileProvider" 
android:authorities="com.example.cameraalbumtest.fileprovider" 
android:exported="false" 
android:grantUriPermissions="true"> 
<meta-data 
android:name="android.support.FILE PROVIDER PATHS" 
android:resource="@xml/file paths" /> 
</provider> 
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</appLication> 
</manifest> 


android:name 属 性 的 值 是 固定 的 , 而 android:authorities 属 性 的 值 必须 和 刚才 
FileProvider.getUriForFile() 方 法 中 的 第 二 个 参数 一 致 。 另 外 ， 这 里 还 在 <provider> 
标签 的 内 部 使 用 <meta-data> 指 定 Uri 的 共享 路 径 ， 并 引用 了 一 个 GxmL/file paths 资 源 。 
当然 ， 这 个 资源 现在 还 是 不 存在 的 ， 下面 我 们 就 来 创建 它 。 


右 击 res 目 录 一 New 一 Directory , 创建 一 个 xmI 上 有 目录， 接着 右 击 xmI 目 录 一 New 一 File， 创建 一 
个 file_paths.xml 文 件 。 然 后 修改 file_paths.xml 文 件 中 的 内 容 ， 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 

<paths xmlns:android="http://schemas.android.com/apk/res/android"> 
<external-path name="my images" path="/" /> 

</paths> 


external-path 就 是 用 来 指定 Uri 共 享 路 径 的 ，name 属 性 的 值 可 以 随便 填 ，path 属 性 的 值 表 
示 共 享 的 具体 路 径 。 这 里 使 用 一 个 单 斜 线 表 示 将 整个 SD 卡 进行 共享 ， 当 然 你 也 可 以 仅 共享 存放 
output image.jpg 这 张 图 片 的 路 径 。 


这 样 代 码 就 编写 完了 ， 现 在 将 程序 运行 到 手机 上 ,点击 “Take Photo” 按 钮 即 可 进行 拍照 ， 如 图 
9.14 所 示 。 拍 照 完成 后 ,点击 中 间 按 钮 就 会 回 到 我 们 程序 的 界面 。 同 时 ， 拍摄 的 照片 也 显示 出 
来 了 ， 如 图 9.15 所 示 。 
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图 9.14 打开 摄像 头 拍照 
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CameraAlbumTest 


TAKE PHOTO 


图 9.15 拍照 的 最 终 效果 


9.3.2 ”从 相册 中 选择 图 片 


虽然 调用 摄像 头 拍照 既 方便 又 快捷 ， 但 我 们 并 不 是 每 次 都 需要 当场 拍 一 张 照片 的 。 因 为 每 个 人 
的 手机 相册 里 应 该 都 会 存 有 许多 张 图 片 ， 直 接 从 相册 里 选取 一 张 现 有 的 图 片 会 比 打开 相机 拍 一 
张 照片 更 加 常用 。 一 个 优秀 的 应 用 程序 应 该 将 这 两 种 选择 方式 都 提供 给 用 户 ， 由 用 户 来 决定 使 
用 哪 一 种 。 下 面 我 们 就 来 看 一 下 ， 如 何 才能 实现 从 相册 中 选择 图 片 的 功能 。 


还 是 在 CameraAlbumTest 项 目的 基础 上 进行 修改 ， 编 辑 activity_main.xm|I 文 件 ， 在 布局 中 
添加 一 个 按钮 , 用 于 从 相册 中 选择 图 片 ,代码 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 
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<Button 
android:id="@+id/takePhotoBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Take Photo" /> 


<Button 
android:id="@+id/fromAlbumBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="From Album" /> 


<ImageView 
android:id="@+id/imageView" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" /> 


</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ,加 入 从 相册 选择 图 片 的 逻辑 ， 代码 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
val fromAlbum = 2 
override fun onCreate(savedInstanceState: Bundle?) { 


fromAlbumBtn.setOnClickListener { 
// 打开 文件 选择 器 
val intent = Intent(Intent.ACTION OPEN DOCUMENT) 
intent.addCategory(Intent.CATEGORY OPENABLE) 
// 指定 只 显示 图 片 
intent .type = "image/*" 
startActivityForResult(intent, fromAlbum) 


} 


override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { 
super.onActivityResult(requestCode, resultCode, data) 
when (requestCode) { 


fromAlbum -> { 
if (resultCode == Activity,RESULT OK && data != null) { 
data.data?.let { uri -> 
// 将 选择 的 图 片 显示 
val bitmap = getBitmapFromUri(uri) 
imageView,.setImageBitmap(bitmap) 


} 


private fun getBitmapFromUri(uri: Uri) = contentResolver 


.openFileDescriptor(uri, "r")?.use { 
BitmapFactory.decodeFileDescriptor(it.fileDescriptor) 
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可 以 看 到 ,在 “From Album” 按 钮 的 点 击 事件 里 ， 我 们 先 构建 了 一 个 Intent 对 象 ， 并 将 它 的 
action 指 定 为 Intent .ACTION OPEN DOCUMENT , 表示 打开 系统 的 文件 选择 器 。 接 着 给 这 个 
Intent 对 象 设置 一 些 条 件 过 滤 ， 只 人 允许 可 打开 的 图 片 文件 显示 出 来 ， 然 后 调用 
startActivityForResult() 方 法 即 可 。 注 意 , 在 调用 startActivityForResult() 方 法 
的 时 候 ， 我 们 给 第 二 个 参数 传 入 的 值 变 成 了 fromALbum , 这 样 当选 择 完 图 片 回 到 
onActivityResult() 方 法 时 ， 就 会 进入 fromALlbum 的 条 件 下 处 理 图 片 。 


接 下 来 的 部 分 就 很 简单 了 ， 我 们 调用 了 返回 Intent 的 getData ( ) 方 法 来 获取 选中 图 片 的 Uri ， 
然后 再 调用 getBitmapFromUri() 方 法 将 Uri 转 换 成 Bitmap 对 象 ， 最 终 将 图 片 显示 到 界面 
上 。 


现在 重新 运行 程序 , 然后 点 击 一 下 “From Album" 按 钮 ， 就 会 打开 系统 的 文件 选择 器 了 ， 如 图 
9.16 所 示 。 


9:09 :和 


一 - 搜索 此 手机 


刘 览 其 他 应 用 中 的 文件 


过 Wi 人 


手机 上 的 近期 图 片 渴 


图 9.16 打开 文件 选择 器 
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然后 随意 选择 一 张 图 片 ， 回 到 我 们 程序 的 界面 ， 选 中 的 图 片 应 该 就 会 显示 出 来 了 ， 如 图 9.17 所 
不 。 
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CameraAlbumTest 


TAKE PHOTO 


FROM ALBUM 


图 9.17 选择 图 片 的 最 终 效果 


调用 摄像 头 拍 照 以 及 从 相册 中 选择 图 片 是 很 多 Android 应 用 都 会 带 有 的 功能 ， 现 在 你 已 经 将 这 两 
种 技术 都 学 会 了 ， 如 果 将 来 在 工作 中 需要 开发 类 似 的 功能 ， 相 信 你 一 定 能 轻松 完成 的 。 不 过 ， 
目前 我 们 的 实现 还 不 算 完美 ， 因 为 如 果 某 些 图 片 的 像素 很 高 ， 直 接 加 载 到 内 存 中 就 有 可 能 会 导 
致 程序 崩 演 。 更 好 的 做 法 是 根据 项 目的 需求 先 对 图 片 进行 适当 的 压缩 ， 然后 再 加 载 到 内 存 中 。 
至 于 如 何 对 图 片 进 行 压缩 ， 就 要 考验 你 查阅 资料 的 能 力 了 ， 这 里 就 不 再 展开 进行 讲解 了 。 


www.blogss.cn 


9.4 播放 多 媒体 文件 


手机 上 最 常见 的 休闲 方式 之 无 疑问 就 是 听 音 乐 和 看 电影 了 ， 随 着 移动 设备 的 普及 ， 越 来 越 多 的 
人 可 以 随时 享受 优美 的 音乐 ， 观 看 精彩 的 电影 。Android 在 播放 音频 和 视频 方面 做 了 相当 不 错 的 
支持 ， 它 提供 了 一 套 较为 完整 的 API ,使 得 开发 者 可 以 很 轻松 地 编写 出 一 个 简易 的 音频 或 视频 播 
放 絮 ,下 面 我 们 就 来 具体 地 学 习 一 下 。 


9.4.1 播放 音频 


在 Android 中 播放 音频 文件 一 般 是 使 用 MediaPlayer 类 实现 的 ， 它 对 多 种 格式 的 音频 文件 提供 
了 非常 全 面 的 控制 方法 ， 从 而 使 播放 音乐 的 工作 变 得 十 分 简单 。 表 9.1 列 出 了 MediaPlayer 类 
中 一 些 较 为 常用 的 控制 方法 。 


表 9.1 MediaPLayer 类 中 常用 的 控制 方法 


方法 名 功能 描述 


设置 要 播放 的 音频 文件 的 位 置 


setDataSource() 


prepare() 在 开始 播放 之 前 调用 ， 以 完成 准备 工作 


start() 


开始 或 继续 播放 音频 


pause() 


reset() 


暂停 播放 音频 


将 MediaPlayer 对 象 重 置 到 刚刚 创建 的 状态 


seekTo() 


从 指定 的 位 置 开 始 播放 音频 


stop() 


停止 播放 音频 。 调 用 后 的 MediaPlayer 对 象 无 法 再 播放 音频 


release() 


isPlaying() 


释放 与 MediaPlayer 对 象 相 关 的 资源 


判断 当前 MediaPlayer 是 否 正在 播放 音频 


getDuration() 


获取 载 入 的 音频 文件 的 时 长 


简单 了 解 了 上 述 方法 后 ,我 们 再 来 梳理 一 人 MediaPLayer 的 工作 流程 。 首 先 需要 创建 一 个 
MediaPLayer 对 象 , 然后 调用 setDataSource() 方 法 设置 音频 文件 的 路 径 ， 再 调用 
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prepare( ) 方 法 使 MediaPLayer 进 入 准备 状态 ， 接 下 来 调用 start ( ) 方 法 就 可 以 开始 播放 音 
频 ， 调用 pause ( ) 方 法 就 会 暂停 播放 ， 调 用 reset ( ) 方 法 就 会 停止 播放 。 


下 面 就 让 我 们 通过 一 个 具体 的 例子 来 学 习 一 下 吧 ， 新 建 一 个 PlayAudioTest 项 目 ， 然 后 修改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/play" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Play" /> 


<Button 
android:id="@+id/pause" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Pause" /> 


<Button 
android:id="@+id/stop" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Stop" /> 


</LinearLayout> 
布局 文件 中 放置 了 3 个 按钮 , 分别 用 于 对 音频 文件 进行 播放 、 和 暂停 和 停止 操作 。 


MediaPlayer 可 以 用 于 播放 网 络 、 本 地 以 及 应 用 程序 安装 包 中 的 音频 。 这 里 简单 起 见 ， 我 们 就 
以 播放 应 用 程序 安装 包 中 的 音频 来 举例 吧 。 


Android Studio 人 允许 我 们 在 项 目 工程 中 创建 一 个 assets 上 和 目录， 并 在 这 个 目录 下 存放 任意 文件 和 
子 目 录 , 这些 文件 和 子 目录 在 项 目 打包 时 会 一 并 被 打包 到 安装 文件 中 ， 然 后 我 们 在 程序 中 就 可 
以 借助 AssetManager 这 个 类 提供 的 接口 对 assets 目 录 下 的 文件 进行 读 取 。 


那么 首先 来 创建 assets 目 录 吧 ，, 它 必 须 创建 在 app/src/main 这 个 目录 下 面 ， 也 就 是 和 java、 
res 这 两 个 目录 是 平 级 的 。 右 击 app/src/mainNew 一 Directory , 在 弹出 的 对 话 框 中 输 
入 “assets”, 目录 就 创建 完成 了 。 


由 于 我 们 要 播放 音频 文件 ， 这 里 我 提前 准备 好 了 一 份 music.mp3 资 源 (资源 下 载 方式 见 前 
言 ) ,将 它 放 入 assets 目 录 中 即 可 ， 如 图 9.18 所 示 。 
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图 9.18 将 音频 资源 放 入 assets 目 录 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
private val mediaPlayer = MediaPlayer() 


override fun onCreate(savedInstanceState: Bundle?) { 

super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
initMediaPlayer() 
play.setOnClickListener { 

if (!mediaPLayer.isPLaying) { 

mediapPlayer.start() // 开始 播放 
} 


} 
pause.setOnClickListener { 
if (mediaPlayer.isPlaying) { 
mediaPLayer.pause() // 暂停 播放 
} 
} 
stop.setOnClickListener { 
if (mediaPlayer.isPlaying) { 
mediaPlayer.reset() // 停止 播放 
initMediaPlayer() 


} 


private fun initMediaPLayer() { 
val assetManager = assets 
val fd = assetManager.openFd("music.mp3") 
mediaPlayer.setDataSource(fd.fileDescriptor, fd.start0Offset, fd.1length) 
mediaPlayer.prepare() 


} 


override fun onDestroy() { 
super.onDestroy() 
mediaPlayer.stop() 
mediaPlayer.release() 
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可 以 看 到 ， 在 类 初始 化 的 时 候 ， 我们 就 先 创建 了 一 个 MediaPlayer 的 实例 ， 然 后 在 
onCreate( ) 方 法 中 调用 initMediaPLayer() 方 法 , 为 MediaPlayer 对 象 进行 初始 化 操作 。 
在 initMediaPLayer() 方 法 中 ,首先 通过 getAssets ( ) 方 法 得 到 了 一 个 AssetManager 的 
实例 , AssetManager 可 用 于 读 取 assets 目 录 下 的 任何 资源 。 接 着 我 们 调用 了 openFd ( ) 方 法 
将 音频 文件 句柄 打开 ,后面 又 依次 调用 了 setDataSource() 方 法 和 prepare( ) 方 法 ,为 
MediaPlayer 做 好 了 播放 前 的 准备 。 


接 下 来 我 们 看 一 下 各 个 按钮 的 点 击 事件 中 的 代码 。 当 点 击 “Play” 按 钮 时 会 进行 判断 ， 如 果 当 前 

MediaPlayer 没 有 正在 播放 音频 ， 则 调用 start( ) 方 法 开始 播放 。 当 点 击 “Pause” 按 钮 时 会 判 

断 ， 如 果 当 前 MediaPlayer 正 在 播放 音频 ， 则 调用 pause ( ) 方 法 暂停 播放 。 当 点 击 “Stop" 按 钮 
时 会 判断 ， 如 果 当 前 MediaPlayer 正 在 播放 音频 ， 则 调用 reset ( ) 方 法 将 MediaPlayer 重 置 为 
刚刚 创建 的 状态 ， 然 后 重新 调用 一 遍 initMediaPlayer() 方 法 。 


最 后 在 onDestroy () 方 法 中 ,我 们 还 需要 分 别 调用 stop ( ) 方 法 和 release() 方 法 , 将 与 
MediaPlayer 相 关 的 资源 释放 掉 。 


这 样 一 个 简易 版 的 音乐 播放 器 就 完成 了 ， 现 在 将 程序 运行 到 手机 上 ， 界面 如 图 9.19 所 示 。 
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图 9.19 音乐 播放 器 主 界面 


点 击 一 下 “Play" 按 钮 ,优美 的 音乐 就 会 响起 ， 然 后 点 击 “Pause” 按 钮 ， 音乐 就 会 停 住 ,再 次 点 
击 “Play "按钮 ， 会 接着 暂停 之 前 的 位 置 继 续 播放 。 这 时 如 果 点 击 一 下 “Stop”" 按 钮 ,音乐 也 会 售 
住 , 但 是 当 再 次 点 击 “Play" 按 钮 时 ， 音乐 就 会 从 头 开始 播放 了 。 


9.4.2 播放 视频 


播放 视频 文件 其 实 并 不 比 播放 音频 文件 复杂 ,主要 是 使 用 VideoView 类 来 实现 的 。 这 个 类 将 视 
频 的 显示 和 控制 集 于 一 身 ， 我 们 仅仅 借助 它 就 可 以 完成 一 个 简易 的 视频 播放 器 。VideoView 的 
用 法 和 MediaPlayer 也 比较 类 似 ， 常 用 方法 如 表 9.2 所 示 。 


表 9.2 VideoView 的 常用 方法 
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方法 名 功能 描述 
setVideopath() 设置 要 播放 的 视频 文件 的 位 置 
start() 开始 或 继续 播放 视频 
pause() 暂停 播放 视频 
resume() 将 视频 从 头 开始 播放 
seekTo() 从 指定 的 位 置 开 始 播放 视频 
isPtaying() 判断 当前 是 否 正在 播放 视频 
getDuration() 获取 载 入 的 视频 文件 的 时 长 
suspend () 释放 ViedoView 所 占用 的 资源 


我 们 还 是 通过 一 个 实际 的 例子 来 学 习 一 下 吧 ， 新 建 PlayVideoTest 项 目 ， 然 后 修改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" > 


<Button 
android:id="@+id/play" 
android:Layout width="Qdp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Play" /> 


<Button 
android:id="@+id/pause" 
android:Layout width="Qdp" 
android:layout height="wrap content" 
android:Layout weight="1" 
android:text="Pause" /> 


<Button 
android:id="@+id/replay" 
android:Layout width="Qdp" 
android:layout height="wrap content" 
android:layout weight="1" 
android:text="Replay" /> 
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</LinearLayout> 


<VideoView 
android:id="@+id/videoView" 
android:layout width="match parent" 
android:layout height="wrap content" /> 


</LinearLayout> 


这 个 布局 文件 中 同样 放置 了 3 个 按钮 ,分别 用 于 控制 视频 的 播放 、 和 暂停 和 重新 播放 。 另 外 在 按钮 
的 下 面 又 放置 了 一 个 VideoView ，, 稍 后 的 视频 就 将 在 这 里 显示 。 


接 下 来 的 问题 就 是 存放 视频 资源 了 ， 很 可 惜 的 是 ，VideoView 不 支持 直接 播放 assets 目 录 下 的 
视频 资源 ， 所 以 我 们 只 能 寻找 其 他 的 解决 方案 。res 目 录 下 人 允许 我 们 再 创建 一 个 raw 目 录 , 像 诸 
如 音频 、 视 频 之 类 的 资源 文件 也 可 以 放 在 这 里 ， 并且 VideoView 是 可 以 直接 播放 这 个 目录 下 的 
视频 资源 的 。 


现在 右 击 app/src/main/resNew 一 Directory ，, 在 弹出 的 对 话 框 中 输入 “raw”, 完成 raw 目 录 
的 创建 ， 并 把 要 播放 的 视频 资源 放 在 里 面 。 这 里 我 提前 准备 了 一 个 video.mp4 资 源 (资源 下 载 
方式 见 前 言 ) ， 如 图 9.20 所 示 ， 你 也 可 以 使 用 自己 准备 的 视频 资源 。 


main 
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图 9.20 ”将 视频 资源 放 到 raw 目 录 当 中 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
val uri = Uri.parse("android,.resource://$packageName/${R.raw.video}") 
videoView.setVideoURI(uri) 
play.setOnClickListener { 
if (!videoView.isPlaying) { 


www.blogss.cn 


videoView.start() // 开始 播放 


pause.setOnClickListener { 
if (videoView.isPlaying) { 
videoView.pause() // 暂停 播放 
} 


replay.setOnClickListener { 
if (videoView.isPlaying) { 
videoView.resume() // 重新 播放 
} 
} 
} 


override fun onDestroy() { 
super.onDestroy() 
videoView.suspend() 


} 


这 段 代 码 现在 看 起 来 就 非常 简单 了 ， 因 为 它 和 前 面 播放 音频 的 代码 比较 类 似 。 我 们 首先 在 
onCreate() 方 法 中 调用 了 Uri.parse() 方 法 , 将 raw 目 录 下 的 video.mp4 文 件 解析 成 了 一 个 
Uri 对 象 ， 这 里 使 用 的 写法 是 Android 要 求 的 固定 写法 。 然 后 调用 VideoView 的 
setVideoURI( ) 方 法 将 刚才 解析 出 来 的 Uri 对 象 传 入 , 这样 VideoView 就 初始 化 完成 了 。 


下 面 看 一 下 各 个 按钮 的 点 击 事件 。 当 点 击 “Play” 按 钮 时 会 判断 ， 如果 当 前 没有 正在 播放 视频 ， 

则 调用 start() 方 法 开始 播放 。 当 点 击 “Pause ”按钮 时 会 判断 ， 如 果 当 前 视频 正在 播放 ， 则 调 
用 pause( ) 方 法 暂停 播放 。 当 点 击 “Replay” 按 钮 时 会 判断 ， 如果 当 前 视频 正在 播放 ， 则 调用 

resume() 方 法 从 头 播放 视频 。 


最 后 在 onDestroy ( ) 方 法 中 ,我 们 还 需要 调用 一 下 suspend ( ) 方 法 ,将 VideoView 所 占用 的 
资源 释放 掉 。 


现在 将 程序 运行 到 于 机 上 ,点击 一 下 "Play" 按 钮 ， 就 可 以 看 到 视频 已 经 开始 播放 了 “， 如 图 9.21 
所 未。 
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图 9.21 _ VideoView 播 放 视频 的 效果 
点 击 “Pause" 按钮 可 以 暂停 视频 的 播放 ， 点击 “Replay” 按 钮 可 以 从 头 播放 视频 。 


这 样 的 话 ， 你 就 已 经 将 VideoView 的 基本 用 法 掌握 得 差不多 了 。 不 过 ， 为 什么 它 的 用 法 和 
MediaPlayer 这 么 相似 呢 ? 其实 VideoView 只 是 帮 有 我 们 做 了 一 个 很 好 的 封装 而 已 ， 它 的 背后 仍 
然 是 使 用 MediaPlayer 对 视频 文件 进行 控制 的 。 另 外 需要 注意 ，VideoView 并 不 是 一 个 万 能 
视频 播放 工具 类 ， 它 在 视频 格式 的 支持 以 及 播放 效率 方面 都 存在 着 较 大 的 不 足 。 所 以 ， 如 果 想 
要 仅仅 使 用 VideoView 就 编写 出 一 个 功能 非常 强大 的 视频 播放 器 是 不 太 现实 的 。 但 是 如 果 只 是 
用 于 播放 一 些 游戏 的 片头 动画 ， 或 者 某 个 应 用 的 视频 宣传 ， 使 用 VideoView 还 是 绰绰有余 的 。 


好 了 ， 关 于 Android 多 媒体 方面 的 知识 你 已 经 学 得 足够 多 了 ， 下 面 就 让 我 们 进入 本 章 的 Kotlin 课 
疝 吧 ，。 
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9.5 ”Kotlin 课 堂 : 使 用 infix 函 数 构建 更 可 读 的 语法 


在 前 面 的 章节 中 ， 我 们 已 经 多 次 使 用 过 A to B 这 样 的 语法 结构 构建 键 值 对 ， 包 括 Kotlin 自 带 的 
mapof ( ) 函数 ， 以 及 我 们 在 第 7 章 中 自己 创建 的 cvOf ( ) 函数 。 


这 种 语法 结构 的 优点 是 可 读 性 高 ， 相 比 于 调用 一 个 函数 ， 它 更 接近 于 使 用 英语 的 语法 来 编写 程 
序 。 可 能 你 会 好 奇 ， 这 种 功能 是 怎么 实现 的 呢 ? to 是 不 是 Kotlin 语 言 中 的 一 个 关键 字 ? 本 节 的 
Kotlin 课 党 中， 我们 就 对 这 个 功能 进行 深度 解密 。 

首先 ,to 并 不 是 Kotlin 语 言 中 的 一 个 关键 字 ,之 所 以 我 们 能 够 使 用 A to B 这 样 的 语法 结构 ， 是 
因为 Kotlin 提 供 了 一 种 高 级 语法 糖 特性 : infix 函 数 。 当 然 ，infix 隐 数 也 并 不 是 什么 难 理解 的 
事物 , 它 只 是 把 编程 语言 函数 调用 的 语法 规则 调整 了 一 下 而 已 ， 比如 A to B 这 样 的 写法 ,实际 
上 等 价 于 A. to(B) 的 写法 。 

下 面 我 们 就 通过 两 个 具体 的 例子 来 学 习 一 下 infix 函 数 的 用 法 ， 先 从 简单 的 例子 看 起 。 


String 类 中 有 一 个 startsWith () 函数 ， 你 一 定 使 用 过 ， 它 可 以 用 于 判断 一 个 
某 个 指定 参数 开头 的 。 比 如 说 下 面 这 段 代 码 的 判断 结果 一 定 会 是 true : 


二 
er 
由 
并 
DY 
Pa 
江 


if ("Hello Kotlin".startsWwith("Hello")) { 
// 处 理 具 体 的 逻辑 
} 


startsWith( ) 郑 数 的 用 法 虽然 非常 简单 ， 但 是 借助 infix 盟 数 ， 我 们 可 以 使 用 一 种 更 具 可 读 
性 的 语法 来 表达 这 段 代 码 。 新 建 一 个 infix.kt 文 件 ， 然后 编写 如 下 代码 : 


infix fun String.beginsWith(prefix: String) = startsWith(prefix) 


首先 ， 除 去 最 前 面 的 infix 关 键 字 不 谈 ,这 是 一 个 String 类 的 扩展 函数 。 我 们 给 String 类 添 
加 了 一 个 beginsWith ( ) 函数 ， 它 也 是 用 于 判断 一 个 字符 串 是 否 是 以 某 个 指定 参数 开头 的 ， 并 
且 它 的 内 部 实现 就 是 调用 的 String 类 的 startsWith( ) 函 数 。 


但 是 加 上 了 infix 关 键 字 之 后 ， beginsWith ( ) 浮 数 就 变 成 了 一 个 infix 国 数 ， 这样 除 了 传统 
的 函数 调用 方式 之 外 , 我 们 还 可 以 用 一 种 特殊 的 语法 糖 格式 调用 beginsWith () 函 数 , 如 下 所 
人 小 : 


if ("Hello Kotlin" beginsWith "Hello") { 
// 处 理 具 体 的 逻辑 


} 


从 这 个 例子 就 能 看 出 ，infix 消 数 的 语法 规则 并 不 复杂 ， 上 述 代码 其 实 就 是 调用 的 ”Hello 
KotLin “这 个 字符 串 的 beginsWith ( ) 少 数 ， 并 传 入 了 一 个 "Hello" 字 符 串 作为 参数 。 但 是 
infix 电 数 允许 我 们 将 洲 数 调用 时 的 小 数 点 、 括 号 等 计算 机 相关 的 语法 去 掉 ， 从 而 使 用 一 种 更 
接近 英语 的 语法 来 编写 程序 ， 让 代码 看 起 来 更 加 具有 可 读 性 。 
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另外 ,infix 函 数 由 于 其 语法 糖 格式 的 特殊 性 ， 有 两 个 比较 严格 的 限制 : 首先 ,infix 消 数 是 
不 能 定义 成 顶层 永 数 的 ， 它 必须 是 某 个 类 的 成 员 函 数 ， 可 以 使 用 扩展 函数 的 方式 将 它 定 义 到 某 
个 类 当中 ; 其 次 ，infix 哨 数 必须 接收 且 只 能 接收 一 个 参数 ， 至 于 参数 类 型 是 没有 限制 的 。 只 
有 同时 满足 这 两 点 ，infix 消 数 的 语法 糖 才 具 备 使 用 的 条 件 ， 你 可 以 思考 一 下 是 不 是 这 个 道 
理 。 


看 完了 简单 的 例子 ， 接 下 来 我 们 再 看 一 个 复杂 一 些 的 例子 。 比 如 这 里 有 一 个 集合 ， 如 果 想 要 判 
断 集合 中 是 否 包 括 某 个 指定 元 素 ， 一 般 可 以 这 样 写 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 
if (list.contains("Banana")) { 
// 处 理 具体 的 逻辑 


很 简单 对 吗 ? 但 我 们 仍然 可 以 借助 infix 函 数 让 这 段 代 码 变 得 更 加 具有 可 读 性 。 在 infix.kt 文 件 
中 添加 如 下 代码 : 


infix fun <T> CoLLection<T> .has(eLement: T) = contains(eLement ) 


可 以 看 到 ， 我 们 给 CoLLection 接 口 添 加 了 一 个 扩展 函数 , 这 是 因为 CoLLection 是 java 以 及 
Kotlin 所 有 集合 的 总 接口 ， 因 此 给 CoLLection 添 加 一 个 has ( ) 函 数 ， 那 么 所 有 集合 的 子 类 就 都 
可 以 使 用 这 个 函数 了 。 


另外 ， 这 里 还 使 用 了 上 一 章 中 学 习 的 泛 型 水 数 的 定义 方法 ,从 而 使 得 has ( ) 函数 可 以 接收 任意 
具体 类 型 的 参数 。 而 这 个 函数 内 部 的 实现 逻辑 就 相当 简单 了 ， 只 是 调用 了 CoLtLection 接 口中 
的 contains ( ) 函 数 而 已 。 也 就 是 说 ，has ( ) 函数 和 contains ( ) 函数 的 功能 实际 上 是 一 模 一 
样 的 , 只 是 它 多 了 一 个 infix 关 键 字 ， 从 而 拥有 了 infix 函 数 的 语法 糖 功能 。 


现在 我 们 就 可 以 使 用 如 下 的 语法 来 判断 集合 中 是 否 包括 某 个 指定 的 元 素 : 


val List = list0f("Apple", "Banana", "Orange", "Pear", "Grape") 


if (list has "Banana") { 
// 处 理 具体 的 逻辑 


} 


好 了 ， 两 个 例子 都 已 经 看 完了 ， 你 对 于 infix 函 数 应 该 也 了 解 得 差不多 了 。 但 是 或 许 现在 你 的 
心中 还 有 一 个 疑惑 没有 解 开 ， 就 是 nap0f ( ) 函数 中 人 允许 我 们 使 用 A_ to B 这 样 的 语法 来 构建 键 值 
对 ，, 它 的 具体 实现 是 怎样 的 呢 ? 为 了 解 开 谜团 ， 我 们 直接 来 看 一 看 to ( ) 函数 的 源码 吧 ， 按 住 
Ctrl 键 (Mac 系 统 是 command 键 ) 点 击 图 数 名 即 可 查看 它 的 源码 ， 如 下 所 示 : 


public infix fun <A, B> A.to(that: B): Pair<A, B> = Pair(this, that) 


可 以 看 到 ， 这 里 使 用 定义 泛 型 函数 的 方式 将 to ( ) 函数 定义 到 了 A 类 型 下 ， 并 且 接 收 一 个 B 类 型 的 
参数 。 因 此 A 和 Be 可 以 是 两 种 不 同类 型 的 泛 型 ， 也 就 使 得 我 们 可 以 构建 出 字符 串 to 整 型 这 样 的 键 
值 对 。 


再 来 看 to ( ) 永 数 的 具体 实现 ， 非 常 简单 ， 就 是 创建 并 返回 了 一 个 Pair 对 象 。 也 就 是 说 ，A to 
B 这 样 的 语法 结构 实际 上 得 到 的 是 一 个 包含 A、B 数 据 的 Pai r 对 象 ， 而 map0f ( ) 纯 数 实际 上 接收 
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的 正 是 一 个 Pair 类 型 的 可 变 参数 列表 ， 这 样 我 们 就 将 这 种 神奇 的 语法 结构 完全 解密 了 。 


本 着 动手 实践 的 精神 ， 其 实 我 们 也 可 以 模仿 to ( ) 函数 的 源码 来 编写 一 个 自己 的 键 值 对 构建 函 
数 。 在 infix.kt 文 件 中 添加 如 下 代码 : 


infix fun <A, B> A.with(that: B): Pair<A, B> = Pair(this, that) 


这 里 只 是 将 to ( ) 函数 改名 成 了 with( ) 函数 ， 其 他 实现 逻辑 是 相同 的 ， 因 此 相信 没有 什么 解释 
的 必要 。 现 在 我 们 的 项 目 中 就 可 以 使 用 with ( ) 函 数 来 构建 键 值 对 了 ， 还 可 以 将 构建 的 键 值 对 传 
入 map0f() 方 法 中 : 


val map = map0Of("Apple" with 1, "Banana" with 2, "Orange" with 3, "Pear" with 4, 
"Grape" with 5) 


是 不 是 很 神奇 ? 这 就 是 infixX 函 数 给 我 们 带 来 的 诸多 有 意思 的 功能 ， 灵 活 运用 它 确实 可 以 让 语 
法 变 得 更 具 可 读 性 。 


本 章 的 Kotlin 课 堂 就 到 这 里 ， 接 下 来 我 们 要 再 次 进入 本 书 的 特殊 环节 ， 学习 Git 的 更 多 用 法 。 
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9.6 Git 时间 : 版 本 控制 工具 进 阶 


在 上 一 次 的 Git 时 间 里 ， 我 们 学 习 了 关于 Git 最 基本 的 用 法 ， 包 括 安装 Git、 创 建 代 码 仓库 ， 以 及 
提交 本 地 代码 。 本 节 中 我 们 将 要 学 习 更 多 的 使 用 技巧 ， 不 过 ， 在 开始 之 前 要 先 把 准备 工作 做 
好 。 


所 谓 的 准备 工作 就 是 要 给 一 个 项 目 创建 代码 仓库 。 这 里 就 选择 在 PlayVideoTest 项 目 中 创建 吧 。 
打开 终端 界面 ， 进 入 这 个 项 目的 根 目录 下 面 ， 然 后 执行 git init 命 令 , 如 图 9.22 所 示 。 


guolindeMacBook-Pro:~ guolin$ cd AndroidStudioProjects/AndroidFirstLine/PlayVideoTest/ 
guolindeMacBook-Pro:PlayVideoTest guolin$ git init 


Initialized empty Git repository in /Users/guolin/AndroidStudioProjects/AndroidFirstLine/PlayVideoTest/.git/ 
guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.22 创建 代码 仓库 
这 样 准备 工作 就 已 经 完成 了 ， 让 我 们 继续 开始 Git 之 旅 吧 。 
9.6.1 名 略 文件 


代码 仓库 现在 已 经 创建 好 了 ， 接 下 来 我 们 应 该 去 提交 PlayVideoTest 项 目 中 的 代码 。 不 过 在 提交 
之 前 ， 你 也 许 应 该 思考 一 下 ， 是 不 是 所 有 的 文件 都 需要 加 入 版 本 控制 当中 呢 ? 


在 第 1 章 介绍 Android 项 目 结构 的 时 候 我 们 提 到 过 ，build 目 录 下 的 文件 都 是 编译 项 目 时 自动 生 
成 的 ， 我 们 不 应 该 将 这 部 分 文件 添加 到 版 本 控制 当中 ， 那么 如 何 才能 实现 这 样 的 效果 呢 ? 


Git 提 供 了 一 种 可 配 性 很 强 的 机 制 ， 人 允许 用 户 将 指定 的 文件 或 目录 排除 在 版 本 控制 之 外 ， 它 会 检 
查 代码 仓库 的 目录 下 是 否 存 在 一 个 名 为 .gitignore 的 文件 ， 如果 存在 ， 就 去 一 行 行 读 取 这 个 文件 
中 的 内 容 ， 并 把 每 一 行 指定 的 文件 或 目录 排除 在 版 本 控制 之 外 。 注 意 ，.gitignore 中 指定 的 文件 
或 目录 是 可 以 使 用 “*” 通 配 符 的 。 


神奇 的 是 ， 我 们 并 不 需要 自己 去 创建 .gitignore 文件 , Android Studio 在 创建 项 目的 时 候 会 
动 帮 我 们 创建 出 两 个 .gitignore 文件 ， 一 个 在 根 目 录 下 面 ， 一 个 在 app 模 块 下 面 。 首 先 看 一 下 
根 目 录 下 面 的 .gitignore 文件 , 如 图 9.23 所 示 。 


.gitignore 


水 ,mL 

.gradle 
/local.properties 
idea/caches 
idea/Libraries 
idea/modules.xml 
idea/workspace.xml 
idea/navEditor.xm\l 
,idea/assetWizardSettings.xml 
.DS_Store 

/build 

/captures 
.externalNativeBuild 


i 
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图 9.23 根 目录 下 面 的 .gitignore 文 件 


这 是 Android Studio 自 动 生成 的 一 些 默认 配置 ， 通 常情 况 下 ， 这 部 分 内 容 都 不 用 添加 到 版 本 控 
制 当中 。 我 们 来 简单 阅读 一 下 这 个 文件 ， 除 了 *.iml 表 示 指 定 任意 以 .iml 结 尾 的 文件 ， 其 他 都 是 
指定 的 具体 的 文件 名 或 者 目录 名 ， 上 面 配置 中 的 所 有 内 容 都 不 会 被 添加 到 版 本 控制 当中 ， 因 为 
基本 是 一 些 由 IDE 自 动 生成 的 配置 。 


再 来 看 一 下 app 模 块 下 面 的 .gitignore 文 件 ， 这 个 就 简单 多 了 ， 如 图 9.24 所 示 。 


习 .gitignore 


/build 


图 9.24 _ app 模块 下 面 的 .gitignore 文 件 


由 于 app 模 块 下 面 大 多 是 我 们 编写 的 代码 ， 因 此 默认 情况 下 只 有 其 中 的 build 目 录 不 会 被 添加 到 
版 本 控制 当中 。 


当然 ， 我们 完全 可 以 对 以 上 两 个 文件 进行 任意 修改 ， 来 满足 特定 的 需求 。 比 如 说 ，app 模 块 下 的 
所 有 测试 文件 都 只 是 给 我 自己 使 用 的 ， 我 并 不 想 把 它们 添加 到 版 本 控制 中 ， 那 么 就 可 以 这 样 修 
改 app/.gitignore 文 件 中 的 内 容 : 

/build 


/src/test 
/src/androidTest 


没 错 ， 只 需 添 加 这 样 两 行 配置 即 可 ， 因 为 所 有 的 测试 文件 都 是 放 在 这 两 个 目录 下 的 。 现 在 我 们 
可 以 提交 代码 了 ， 先 使 用 add 命 令 将 所 有 的 文件 进行 添加 ， 如 下 所 示 : 


然后 执行 Commit 命 令 完成 提交 ,如 下 所 示 : 


git commit -m "First commit." 


9.6.2 查看 修改 内 容 


在 进行 了 第 一 次 代码 提交 之 后 ， 我 们 后 面 还 可 能 会 对 项 目 不 断 地 进行 维护 或 添加 新 功能 等 。 比 
较 理 想 的 情况 是 ， 每 当 完 成 了 一 小 块 功能 ， 就 执行 一 次 提交 。 但 是 如 果 某 个 功能 涉及 的 代码 比 
较 多 ， 有 可 能 写 到 后 面 的 时 候 我 们 就 已 经 忘记 前 面 修改 什么 东西 了 。 遇 到 这 种 情况 时 不 用 担 
心 ，Git 全 都 帮 你 记 着 呢 ! 下 面 我 们 就 来 学 习 一 下 如 何 使 用 Git 查 看 自 上 次 提交 后 文件 修改 的 内 
谷 。 


查看 文件 修改 情况 的 方法 非常 简单 ， 只 需要 使 用 status 命 令 就 可 以 了 ， 在 项 目的 根 目 录 下 输入 


和 人生 a 
命令 : 
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“git status 


然后 Git 会 提示 目前 项 目 中 没有 任何 可 提交 的 文件 ， 因 为 我 们 刚刚 才 提 交 过 嘛 。 现 在 对 
PlayVideoTest 项 目 中 的 代码 稍 做 一 下 改动 ， 修改 MainActivity 中 的 代码 ,如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
play.setOnClickListener { 


Log.d("MainActivity", "video is playing") 


} 


这 里 我 们 仪 仅 是 在 play 按 钮 的 点 击 事件 中 添加 了 一 行 日 志 打 印 。 然 后 重新 输入 git status 命 
令 ， 结 果 如 图 9.25 所 示 。 


guolindeMacBook-Pro:PlayVideoTest guolin$ git status 
On branch master 
Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


no changes added to commit (use "git add" and/or "git commit -a") 
guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.25 查看 文件 变动 情况 


可 以 看 到 ，Git 提 醒 我 们 MainActivity.kt 这 个 文件 已 经 发 生 了 更 改 ， 那 么 如 何 才 能 看 到 更 改 的 内 
容 呢 ? 这 就 需要 借助 diff 命 令 了 ， 用 法 如 下 : 


“git diff 


这 样 可 以 查看 所 有 文件 的 更 改 内 容 ， 如 果 你 只 想 查看 MainActivity.kt 这 个 文件 的 更 改 内 容 , 可 
以 在 后 面 加 上 完整 的 文件 路 径 : 


git diff app/src/main/java/com/example/playvideotest/MainActivity.kt 


命令 的 执行 结果 如 图 9.26 所 示 。 
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guolindeMacBook-Pro:PlayVideoTest guolin$ git diff app/src/main/java/com/example/playvideotest/MainActivity. kt 
diff --git a/app/src/main/java/com/example/playvideotest/MainActivity.kt b/app/src/main/java/com/exaomple/playvideotest/ 


- a/app/src/main/java/com/example/playvideotest/MainActivity.kt 
4H PR SPO/ en mep A PU en Est AETV, kt 
+3,7 @@ package com.example.playvideotest 
or android.net.Uri 
import androidx.appcompat.app.AppCompatActivity 
import android.os.Bundle 
import kotlinx. android. synthetic.main.activity_main.* 
Class Po A AppCompatActivity() { 
6 @@ class MainActivity : AppCompatActivityC) { 
if (!videoView.isplaying) { 
videoView.startC) // 开始 播放 
pause.setOnClickListener { 
if (videoView.isplaying) { 
guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.26 查看 修改 的 具 休 内 容 


这 样 文件 所 有 的 修改 内 容 就 都 可 以 在 这 里 查看 了 ， 一 览 无 余 。 其 中 ， 变 更 部 分 最 左 侧 的 加 号 代 
表 新 添加 的 内 容 。 如 果 有 删除 内 容 的 话 ， 会 在 最 左 侧 用 减 号 表示 。 


9.6.3 ”撤销 未 提交 的 修改 


有 时 候 我 们 的 代码 可 能 会 写 得 过 于 草率 ， 以 至 于 原本 正常 的 功能 ， 结 果 反 而 被 我 们 改 出 了 问 
题 。 遇 到 这 种 情况 时 也 不 用 着 急 ， 因 为 只 要 代码 还 未 提交 ， 所 有 修改 的 内 容 都 是 可 以 撤销 的 。 


比如 上 一 小 节 中 我 们 给 MainActivity 添 加 了 一 行 日 志 打印 ， 现 在 如 果 想 要 撤销 这 个 修改 就 可 以 
使 用 checkout 命 令 , 用 法 如 下 所 示 : 


git checkout app/src/main/java/com/example/playvideotest/MainActivity.kt 


执行 了 这 个 命令 之 后 ,我 们 对 MainActivity.kt 这 个 文件 所 做 的 一 切 修改 就 应 该 都 被 撤销 了 。 重 
新 运行 git status 命 令 检查 一 下 ， 结果 如 图 9.27 所 示 。 


guolindeMacBook-Pro:PlayVideoTest guolin$ git status 
On branch master 


nothing to commit, working tree clean 
guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.27 重新 查看 文件 变动 情况 
可 以 看 到 ， 当 前 项 目 中 没有 任何 可 提交 的 文件 ， 说 明 撤销 操作 确实 成 功 了 。 


, 这 种 撤销 方式 只 适用 于 那些 还 没有 执行 过 add 命 令 的 文件 ， 如 果 某 个 文件 已 经 被 添加 过 
， 人 下 面 我 们 来 做 个 实验 瞧 一 瞧 。 


首先 仍然 是 给 MainActivity 添 加 一 行 日 志 打印 ， 然 后 输入 命令 :、 


这 样 就 把 所 有 修改 的 文件 都 进行 了 添加 ， 可 以 输入 git status 检 查 一 下 ， 结 果 如 图 9.28 所 
不 。 
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[guolindeMacBook-Pro:PlayVideoTest guolin$ git status 
On branch master 
Changes to be committed: 

(use "git reset HEAD <file>..." to unstage) 


guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.28 再 次 查看 文件 变动 情况 


现在 我 们 再 执行 一 遍 checkout 命 令 ， 你 会 发 现 MainActivity 仍 然 处 于 已 添加 状态 ， 所 修改 的 
内 容 无 法 撤销 掉 。 

这 种 情况 应 该 怎么 办 ? 难道 我 们 还 没 法 后 悔 了 ? 当然 不 是 ， 只 不 过 对 于 已 添加 的 文件 ， 我们 应 
该 先 对 其 取消 添加 ， 然 后 才 可 以 撤回 提交 。 取 消 添加 使 用 的 是 reset 命 令 , 用 法 如 下 所 示 : 


git reset HEAD app/src/main/java/com/example/playvideotest/MainActivity.kt 


然后 再 运行 一 遍 git status 命令 ,你 就 会 发 现 MainActivity.kt 这 个 文件 重新 变 回 了 未 添加 状 
态 ,此 时 就 可 以 使 用 checkout 命 令 将 修改 的 内 容 进行 撤销 了 。 
9.6.4 ”查看 提交 记录 


当 PlayVideoTest 这 个 项 目 开发 了 几 个 月 之 后 ， 我们 可 能 已 经 执行 过 上 百 次 的 提交 操作 了 ， 这 个 
时 候 估计 你 早 就 已 经 忘记 每 次 提交 都 修改 了 哪些 内 容 。 不 过 没关系 ， 忠实 的 Git 一 直 都 帮 我 们 清 
清楚 楚 地 记录 着 呢 ! 可 以 使 用 Log 命 令 查看 历史 提交 信息 ， 用 法 如 下 所 示 : 、 


git log 


由 于 目前 我 们 只 执行 过 一 次 提交 ， 所 以 能 看 到 的 信息 很 少 ， 如 图 9.29 所 示 。 


[guolindeMacBook-Pro:PlayVideoTest guolin$ git log 


Author: Tony <tony@gmail .com> 
Date: Wed Aug 14 19:30:06 2019 +0800 


First commit. 
guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.29 ”查看 提交 记录 


可 以 看 到 ， 每 次 提交 记录 都 会 包含 提交 id、 提 交 人 、 提 交 日 期 以 及 提交 描述 这 4 个 信息 。 那 么 我 
们 再 次 给 MainActivity 添 加 一 行 日 志 打印 ,然后 执行 一 次 提交 操作 ， 如 下 所 示 : 


git add . 
git commit -m "Add log." 


现在 重新 执行 9it tog 命令 ,结果 如 图 9.30 所 示 。 
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guolindeMacBook-Pro:PlayVideoTest guolin$ git log 


Author: Tony <tony@gmail .com> 
Date: Wed Aug 14 20:06:00 2019 +0800 


Add log. 


Author: Tony <tony@gmail .com> 
Date: Wed Aug 14 19:30:06 2019 +0800 


First commit. 
guolindeMacBook-Pro:PlayVideoTest guolin$ 


图 9.30 ”重新 查看 提交 记录 
当 提交 记录 非常 多 的 时 候 ， 如果 我 们 只 想 查 看 其 中 一 条 记录 ,可 以 在 命令 中 指定 该 记录 的 id ”: 


git Log 2960da5042b2dbflabbb3691belb18a6f446b844 


也 可 以 在 命令 中 通过 参数 指定 查看 最 近 的 几 次 提交 ， 比 如 -1 就 表示 我 们 只 想 看 到 最 后 一 次 的 提 
交 记 录 :、 


git log -1 


好 了 ， 本 次 的 Git 时 间 就 到 这 里 ， 下 面 我 们 对 本 章 中 所 学 的 知识 做 个 回顾 吧 。 
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9.7 “小结 与 氮 评 


本 章 我 们 主要 学 习 了 Android 系 统 中 的 各 种 多 媒体 技术 ， 包括 通知 的 使 用 技巧 、 调 用 摄像 头 拍 
照 、 从 相册 中 选取 图 片 ， 以 及 播放 音频 和 视频 文件 。 由 于 所 涉及 的 多 媒体 技术 在 模拟 戎 上 很 难 
看 得 到 效果 ， 因 此 我 还 特意 讲解 了 在 Android 手 机 上 调试 程序 的 方法 。 


另外 ， 在 本 章 的 Kotlin 课 堂 中 ， 我 们 学 习 了 infix 函 数 这 种 高 级 语法 糖 的 用 法 ， 并 且 对 
map0f ( ) 水 数 以 及 A to B 这 种 特殊 的 语法 结构 进行 了 深度 解密 ,那个 困扰 你 心中 很 久 的 疑惑 终 
于 解 开 了 吧 ? 


至 于 本 章 的 Git 时 间 环 节 ， 我 们 学 习 了 Git 的 进 阶 用 法 ， 包括 忽略 文件 、 查 看 修改 内 容 、 查 看 提交 
记录 等 ， 掌 握 了 这 些 内 容 ， 你 基本 上 可 以 比较 熟练 地 使 用 Git 了 。 当 然 ， 后 续 我 们 还 会 继续 学 习 
Git 相 关 的 更 多 用 法 。 


又 是 充实 饱满 的 一 章 啊 ! 现在 多 媒体 方面 的 知识 你 已 经 学 得 足够 多 了 ， 我 希望 你 可 以 很 好 地 将 
它们 消化 掉 ,尤其 是 与 通知 相关 的 内 容 ， 因 为 在 后 面 的 学 习 当中 还 会 用 到 它 。 在 进行 了 一 章 多 
媒体 相关 知识 的 学 习 之 后 ， 你 是 否 想起 来 Android 四 大 组 件 中 还 剩 一 个 没有 学 过 呢 ， 那 么 下 面 就 
让 我 们 进入 Service 的 学 习 旅程 当中 。 
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第 10 章 后 台 默 默 的 劳动 者 ,探究 Service 


记得 在 我 上 大 学 的 时 候 ,iPhone 是 属于 少数 人 拥有 的 稀有 物品 , Android 甚 至 还 没 面世 ， 那 个 
时 候 全 球 的 手机 市 场 是 由 诺基亚 统治 着 的 。 当 时 我 觉得 诺基亚 的 Symbian 操作 系统 做 得 特别 出 
色 ， 因 为 比 起 一 般 的 手机 , 它 可 以 支持 后 台 功 能 。 那 个 时 候 能 够 一 边 打 着 电话 、 听 着 音乐 ， 一 
边 在 后 台 挂 着 QQ ， 是 件 非 常 酷 的 事情 。 我 也 曾经 单纯 地 认为 ， 支 持 后 台 的 手机 就 是 智能 手机 。 


而 如 今 ,Symbian 早已 风光 不 再 ,Android 和 iOS 几 乎 占据 了 智能 手机 全 部 的 市 场 份 额 。 在 这 两 
大 移动 操作 系统 中 ，iOS 一 开始 是 不 支持 后 台 的 ， 后 来 意识 到 这 个 功能 的 重要 性 ， 才 逐渐 加 入 了 
部 分 后 台 功能 。 而 Android 正 好 相反 ， 一 开始 支持 丰富 的 后 台 功 能 ， 后 来 意识 到 后 台 太 过 开放 的 
浆 端 ,于 是 逐渐 肖 碱 了 后 台 功 能 。 不 管 怎么 说 ， 用 于 实现 后 台 功 能 的 Service 属 于 四 大 组 件 之 
一 ， 其 重要 程度 不 言 而 喻 ， 那 么 我 们 自然 要 好 好 学 习 一 下 它 的 用 法 了 。 
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10.1 Service 是 什么 


Service 是 Android 中 实现 程序 后 台 运 行 的 解决 方案 ， 它 非常 适合 执行 那些 不 需要 和 用 户 交 互 而 
且 还 要 求 长 期 运行 的 任务 。Service 的 运行 不 依赖 于 任何 用 户 界面 ， 即使 程序 被 切换 到 后 台 ,或 
者 用 户 打 开 了 另外 一 个 应 用 程序 , Service 仍 然 能 够 保持 正常 运行 。 

不 过 需要 注意 的 是 ，Service 并 不 是 运行 在 一 个 独立 的 进程 当中 的 ， 而 是 依赖 于 创建 Service 时 
所 在 的 应 用 程序 进程 。 当 某 个 应 用 程序 进程 被 杀 掉 时 ， 所 有 依赖 于 该 进程 的 Service 也 会 停止 运 
行 。 

另外 ， 也 不 要 被 Service 的 后 台 概 念 所 迷惑 ， 实 际 上 Service 并 不 会 自动 开局 线程 ， 所 有 的 代码 
都 是 默认 运行 在 主线 程 当中 的 。 也 就 是 说 ， 我 们 需要 在 Service 的 内 部 手动 创建 子 线程 ， 并 在 这 
里 执行 具体 的 任务 ， 否 则 就 有 可 能 出 现 主线 程 被 阻塞 的 情况 。 那 么 本 章 的 第 一 堂 课 ， 我 们 就 先 
来 学 习 一 下 关于 Android 多 线程 编程 的 知识 。 
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10.2 Android 多 线程 编程 


如 果 你 熟悉 java 的 话 ， 对 多 线程 编程 一 定 不 会 陌生 吧 。 当 我 们 需要 执行 一 些 耗 时 操作 ， 比 如 发 
起 一 条 网 络 请 求 时 ， 考 虑 到 网 速 等 其 他 原因 ， 服 务 器 未 必 能 够 立刻 响应 我 们 的 请 求 ， 如 果 不 将 
这 类 操作 放 在 子 线程 里 运行 ， 就 会 导致 主线 程 被 阻塞 ， 从 而 影响 用 户 对 软件 的 正常 使 用 。 下 面 
就 让 我 们 从 线程 的 基本 用 法 开始 学 起 吧 。 


10.2.1 线程 的 基本 用 法 
Android 多 线程 编程 其 实 并 不 比 java 多 线程 编程 特殊 ， 基 本 是 使 用 相同 的 语法 。 比 如 ,定义 一 


个 线程 只 需要 新 建 一 个 类 继承 自 Thread， 然后 重 与 父 类 的 run ( ) 方 法 ， 并 在 里 面 编写 耗 时 逻辑 
即 可 ,如 下 所 示 : 


class MyThread : Thread() { 
override fun run() { 
// 编写 具体 的 逻辑 
} 


} 


那么 该 如 何 启 动 这 个 线程 呢 ? 其 实 很 简单 ， 只 需要 创建 MyTh read 的 实例 ， 然 后 调用 它 的 
start() 方 法 即 可 ， 这样 run( ) 方 法 中 的 代码 就 会 在 子 线程 当中 运行 了 ， 如 下 所 示 : 


MyThread() .start() 


当然 ， 使 用 继承 的 方式 耦合 性 有 点 高 ， 我 们 会 更 多 地 选择 使 用 实现 RunnabtLe 接 口 的 方式 来 定义 
一 个 线程 ， 如 下 所 示 : 


class MyThread : Runnable { 
override fun run() { 
// 编写 具体 的 逻辑 
} 


} 


如 果 使 用 了 这 种 写法 ， 启 动 线程 的 方法 也 需要 进行 相应 的 改变 ,如 下 所 示 : 


val myThread = MyThread () 
Thread(myThread) .start() 


可 以 看 到 , Thread 的 构造 永 数 接收 一 个 RunnabLe 参 数 ， 而 我 们 创建 的 MyTh read 实 例 正 是 一 
个 实现 了 RunnabtLe 接 口 的 对 象 ， 所 以 可 以 直接 将 它 传 入 Thread 的 构造 函数 里 。 接 着 调用 
Thread 的 start () 方 法 ，run() 方 法 中 的 代码 就 会 在 子 线程 当中 运行 了 。 


当然 ， 如 果 你 不 想 专 门 再 定义 一 个 类 去 实现 RunnabtLe 接 口 ， 也 可 以 使 用 Lambda 的 方式 ， 这 种 
写法 更 为 常见 ， 如 下 所 示 : 


Thread { 
// 编写 具体 的 逻辑 
}.start() 
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以 上 几 种 线程 的 使 用 方式 你 应 该 不 会 感到 陌生 ， 因 为 在 java 中 创建 和 局 动 线程 也 是 使 用 同样 的 
方式 。 而 Kotlin 还 给 我 们 提供 了 一 种 更 加 简单 的 开局 线程 的 方式 ， 写 法 如 下 : 


thread { 
// 编写 具体 的 逻辑 


} 


这 里 的 thread 是 一 个 Kotlin 内 置 的 顶层 范 数 ， 我们 只 需要 在 Lambda 表 达 式 中 编 与 具体 的 逻辑 
就 可 以 了 ， 连 start ( ) 方 法 都 不 用 调用 ,thread 函数 在 内 部 帮 我 们 全 部 都 处 理 好 了 。 


了 解 了 线程 的 基本 用 法 后 ， 下 面 我 们 来 看 一 人 Android 多 线程 编程 与 java 多 线程 编程 不 同 的 地 
为 


10.2.2 在 子 线程 中 更 新 U1 


和 许多 其 他 的 GUI 库 一 样 ，Android 的 Ul 也 是 线程 不 安全 的 。 也 就 是 说 ， 如果 想 要 更 新 应 用 程序 
里 的 UI 元 素 ， 必须 在 主线 程 中 进行 ， 否 则 就 会 出 现 异常 。 


眼见 为 实 ， 让 我 们 通过 一 个 具体 的 例子 来 验证 一 下 吧 。 新 建 一 个 AndroidThreadTest 项 目 ， 然 
后 修改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/changeTextBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Change Text" /> 


<TextView 
android:id="@+id/textView" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:text="Hello world" 
android:textSize="20sp" /> 


</RelativeLayout> 


布局 文件 中 定义 了 两 个 控件 : TextView 用 于 在 屏幕 的 正中 央 显 示 一 个 "HeLLo wortLd "字符 
串 ; Button 用 于 改变 TextView 中 显示 的 内 容 ， 我 们 希望 在 点 击 “Button” 后 可 以 把 TextView 中 
显示 的 字符 串 改 成 "Nice to meet you'"。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
changeTextBtn.setOnClickListener { 
thread { 
textView.text = "Nice to meet you" 
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可 以 看 到 ， 我 们 在 “Change Text" 按 钮 的 点 击 事件 里 面 开 启 了 一 个 子 线程 ， 然 后 在 子 线程 中 调 
用 TextView 的 setText ( ) 方 法 将 显示 的 字符 串 改 成 "Nice to meet you"。 代 码 的 逻辑 非常 
简单 ， 只 不 过 我 们 是 在 子 线程 中 更 新 UI 的 。 现 在 运行 一 下 程序 ， 并 点 击 “Change Text” 按 钮 ， 

你 会 发 现 程序 果然 衣 演 了 。 观 察 Logcat 中 的 错误 日 志 , 可 以 看 出 是 由 于 在 子 线程 中 更 新 UI 所 导 
致 的 ,如 图 10.1 所 示 。 


android.view. ViewRootImpl$CalledFromWrongThreadException: Only the original 
thread that created a view hierarchy can touch its views. 


图 10.1 崩溃 的 详细 信息 


由 此 证 实 了 Android 确 实 是 不 允许 在 子 线程 中 进行 UI 操作 的 。 但 是 有 些 时 候 ， 我 们 必须 在 子 线程 
里 执行 一 些 耗 时 任务 ， 然 后 根据 任务 的 执行 结果 来 更 新 相应 的 UI 控件 ， 这 该 如 何 是 好 呢 ? 


对 于 这 种 情况 ，Android 提 供 了 一 套 异 步 消息 处 理 机 制 ， 完 美 地 解决 了 在 子 线程 中 进行 UI 操作 的 
问题 。 我 们 将 在 下 一 小 节 中 再 去 分 析 它 的 原理 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
val updateText = 1 


val handler = object : Handler(Looper.getMaininLooper()) { 
override fun handleMessage(msg: Message) { 
// 在 这 里 可 以 进行 UI 操作 
when (msg.what) { 
updateText -> textView.text = "Nice to meet you" 
} 


} 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
changeTextBtn.setOnClickListener { 
thread { 

val msg = Message() 

msg.what = updateText 

handler.sendMessage(msg) // 将 Message 对 象 发 送出 去 


} 


这 里 我 们 先是 定义 了 一 个 整 型 变量 updateText , 用 于 表示 更 新 TextView 这 个 动作 。 然 后 新 增 
一 个 HandtLer 对 象 ， 并 重 写 父 类 的 handLeMessage( ) 方 法 ,在 这 里 对 具体 的 Message 进 行 处 
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理 。 如 果 发 现 Message 的 what 字 段 的 值 等 于 updateText , 就 将 TextView 显 示 的 内 容 改 
成 “Nice to meet you”。 


下 面 再 来 看 一 下 ”Change Text” 按 钮 的 点 击 事件 中 的 代码 。 可 以 看 到 ,这 次 我 们 并 没有 在 子 线 
程 里 直接 进行 UI 操作 ， 而 是 创建 了 一 个 Message (android.os.Message) 对 象 ， 并 将 它 的 
what 字 段 的 值 指定 为 updateText , 然后 调用 Handler 的 sendMessage() 方 法 将 这 条 
Message 发 送出 去 。 很 快 ，Handler 就 会 收 到 这 条 Message , 并 在 handleMessage() 方 法 中 
对 它 进 行 处 理 。 注 意 此 时 handleMessage() 方 法 中 的 代码 就 是 在 主线 程 当 中 运行 的 了 ， 所 以 
我 们 可 以 放心 地 在 这 里 进行 UI 操作 。 接 下 来 对 Message 携 带 的 what 字 段 的 值 进行 判断 ， 如果 等 
于 updateText , 就 将 TextView 显 示 的 内 容 改 成 “Nice to meet you”。 


现在 重新 运行 程序 , 可 以 看 到 屏幕 的 正中 央 显 示 着 “Hello world"。 然 后 点 击 一 下 "Change 
Text” 按 钮 ， 显示 的 内 容 就 被 替换 成 “Nice to meet you”, 如 图 10.2 所 示 。 


10:47 > | 


AndroidThreadTest 


CHANGE TEXT 


Nice to meet you 


图 10.2 成 功 替换 显示 的 文字 
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这 样 你 就 已 经 掌握 了 Android 异 步 消息 处 理 的 基本 用 法 ， 使 用 这 种 机 制 就 可 以 出 色 地 解决 在 子 线 
程 中 更 新 UI 的 问题 。 不 过 忍 怕 你 对 它 的 工作 原理 还 不 是 很 清楚 ， 下 面 我 们 就 来 分 析 一 下 Android 
异步 消息 处 理 机 制 到 底 是 如 何 工作 的 。 


10.2.3 解析 异步 消息 处 理 机 制 


Android 中 的 异步 消息 处 理 主要 由 4 个 部 分 组 成 : Message、Handler、MessageQueue 和 
Looper。 其 中 Message 和 Handler 在 上 一 小 节 中 我 们 已 经 接触 过 了 ,而 MessageQueue 和 
Looper 对 于 你 来 说 还 是 全 新 的 概念 ， 下 面 我 就 对 这 4 个 部 分 进行 一 下 简要 的 介绍 。 


01. Message 


Message 是 在 线程 之 间 传 递 的 消息 ， 它 可 以 在 内 部 携带 少量 的 信息 ， 用 于 在 不 同 线程 之 间 
传递 数据 。 上 一 小 节 中 我 们 使 用 到 了 Message 的 what 字 段 ， 除 此 之 外 还 可 以 使 用 arg1 和 
arg2 字 段 来 携带 一 些 整 型 数据 ， 使 用 obj 字段 携带 一 个 Object 对象。 


02. Handler 


Handler 顾 名 思 义 也 就 是 处 理 者 的 意思 ，, 它 主要 是 用 于 发 送 和 处 理 消 息 的 。 发 送 消息 一 般 
是 使 用 Handler 的 sendMessage() 方 法 、post() 方 法 等 ,而 发 出 的 消息 经 过 一 系列 地 轧 
转 处 理 后 ， 最 终 会 传递 到 Handler 的 handLeMessage( ) 方 法 中 。 


03. MessageQueue 


MessageQueue 是 消息 队列 的 意思 ， 它 主要 用 于 存放 所 有 通过 Handler 发 送 的 消息 。 这 间 
分 消息 会 一 直 存 在 于 消息 队列 中 ， 等 待 被 处 理 。 每 个 线程 中 只 会 有 一 个 MessageQueue 对 
象 。 


04. Looper 


Looper 是 每 个 线程 中 的 MessageQueue 的 管家 ， 调 用 Looper 的 Loop ( ) 方 法 后 ， 就 会 进入 
一 个 无 限 循环 当中 ， 然 后 每 当 发 现 MessageQueue 中 存在 一 条 消息 时 ， 就 会 将 它 取 出 ， 并 
传递 到 Handler 的 handleMessage() 方 法 中 。 每 个 线程 中 只 会 有 一 个 Looper 对 象 。 


了 解 了 Message、Handler、MessageQueue 以 及 Looper 的 基本 概念 后 ， 我 们 再 来 把 异步 消 
息 处 理 的 整个 流程 梳理 一 遍 。 首 先 需要 在 主线 程 当 中 创建 一 个 HandLer 对 象 ， 并 重 写 
handLeMessage ( ) 方 法 。 然 后 当 子 线程 中 需要 进行 Ul 操 作 时 ， 就 创建 一 个 Message 对 象 ， 并 
通过 Handler 将 这 条 消息 发 送出 去 。 之 后 这 条 消息 会 被 添加 到 MessageQueue 的 队列 中 等 待 被 
处 理 ， 而 Looper 则 会 一 直 兴 试 从 MessageQueue 中 取出 待 处 理 消 息 ， 最 后 分 发 回 Handler 的 
handLeMessage ( ) 方 法 中 。 由 于 Handler 的 构造 哨 数 中 我 们 传 入 了 
Looper.getMainLooper()， 所 以 此 时 handleMessage() 方 法 中 的 代码 也 会 在 主线 程 中 运 
行 ， 于 是 我 们 在 这 里 就 可 以 安心 地 进行 UI 操作 了 。 整 个 异步 消息 处 理 机 制 的 流程 如 图 10.3 所 
示 。 
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取出 待 处 理 消 息 


Looper 

Message 
next 

Message 

MessageQuete next 回调 dispatchMessage() 方 法 
next 
vy 
Message 


Handler “| 一 一 >| handleMessage() 
发 送 新 消息 


图 10.3 异步 消息 处 理 机 制 流程 示意 图 


一 条 Message 经 过 以 上 流程 的 轧 转 调用 后 ， 也 就 从 子 线程 进入 了 主线 程 ， 从 不 能 更 新 UI 变 成 了 
可 以 更 新 U1 , 整个 异步 消息 处 理 的 核心 思想 就 是 如 此 。 


10.2.4 使 用 AsyncTask 


不 过 为 了 更 加 方便 我 们 在 子 线程 中 对 UI 进行 操作 ，Android 还 提供 了 另外 一 些 好 用 的 工具 ， 比 如 
AsyncTask。 借 助 AsyncTask , 即使 你 对 异步 消息 处 理 机 制 完全 不 了 解 , 也 可 以 十 分 简单 地 从 
子 线程 切换 到 主线 程 。 当 然 ，AsyncTask 背 后 的 实现 原理 也 是 基于 异步 消息 处 理 机 制 的 ,只 是 
Android 帮 有 我 们 做 了 很 好 的 封装 而 已 。 


首先 来 看 一 下 AsyncTask 的 基本 用 法 。 由 于 AsyncTask 是 一 个 抽象 类 ， 所 以 如 果 我 们 想 使 用 
它 ， 就 必须 创建 一 个 子 类 去 继承 它 。 在 继承 时 我 们 可 以 为 AsyncTask 类 指定 3 个 泛 型 参数 ,这 3 
个 参数 的 用 途 如 下 。 


。Params。 在 执行 AsyncTask 时 需要 传 入 的 参数 ， 可 用 于 在 后 台 任 务 中 使 用 。 

。Progress。 在 后 台 任 务 执行 时 ， 如果 需要 在 界面 上 显示 当前 的 进度 ， 则 使 用 这 里 指定 的 泛 
型 作为 进度 单位 。 

。ResuLt。 当 任务 执行 完毕 后 ， 如 果 需 要 对 结果 进行 返回 ， 则 使 用 这 里 指定 的 泛 型 作为 返回 
值 类 型 。 


因此 ， 一 个 最 简单 的 自 定义 AsyncTask 就 可 以 写成 如 下 形式 : 


class DownloadTask : AsyncTask<Unit, Int, Boolean>() { 


} 
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这 里 我 们 把 AsyncTask 的 第 一 个 泛 型 参数 指定 为 Unit ,表示 在 执行 AsyncTask 的 时 候 不 需要 传 
入 参数 给 后 台 任务 。 第 二 个 泛 型 参数 指定 为 Int ， 表 示 使 用 整 型 数据 来 作为 进度 显示 单位 。 第 三 
个 泛 型 参数 指定 为 BooLean ， 则 表示 使 用 布尔 型 数据 来 反馈 执行 结果 。 


当然 ， 目 前 我 们 自 定义 的 DownloadTask 还 是 一 个 空 任务 ， 并 不 能 进行 任何 实际 的 操作 ， 我 们 
还 需要 重 写 AsyncTask 中 的 几 个 方法 才能 完成 对 任务 的 定制 。 经 常 需要 重 写 的 方法 有 以 下 4 个 。 


01. onPreExecute() 


这 个 方法 会 在 后 台 任务 开始 执行 之 前 调用 ， 用 于 进行 一 些 界面 上 的 初始 化 操作 ， 比 如 显示 
一 个 进度 条 对 话 框 等 。 


02. doInBackground(Params...) 


这 个 方法 中 的 所 有 代码 都 会 在 子 线程 中 运行 ， 我 们 应 该 在 这 里 去 处 理 所 有 的 耗 时 任务 。 任 
务 一 旦 完成 ， 就 可 以 通过 return 语 句 将 任务 的 执行 结果 返回 ， 如果 AsyncTask 的 第 三 个 泛 
型 参数 指定 的 是 Unit， 就 可 以 不 返回 任务 执行 结果 。 注 意 ， 在 这 个 方法 中 是 不 可 以 进行 UI 
操作 的 ， 如 果 需 要 更 新 UI 元 素 ， 比 如 说 反馈 当前 任务 的 执行 进度 ， 可 以 调用 
pubLishProgress (Progress... ) 方 法 来 完成 。 


03. onProgressUpdate(Progress...) 


当 在 后 台 任 务 中 调用 了 publishProgress(Progress...,) 方 法 后 ， 
onProgressUpdate (Progress...) 方 法 就 会 很 快 被 调用 ,该 方法 中 携带 的 参数 就 是 
在 后 台 任 务 中 传递 过 来 的 。 在 这 个 方法 中 可 以 对 UI 进行 操作 ， 利 用 参数 中 的 数值 就 可 以 对 
界面 元 素 进行 相应 的 更 新 。 


04. onPostExecute (Result) 
当 后 台 任 务 执行 完毕 并 通过 return 语 名 进 行 返回 时 ， 这 个 方法 就 很 快 会 被 调用 。 返 回 的 数 
据 会 作为 参数 传递 到 此 方法 中 ， 可 以 利用 返回 的 数据 进行 一 些 UI 操作 ， 比 如 说 提醒 任务 执 
行 的 结果 ， 以 及 关闭 进度 条 对 话 框 等 。 


因此 ， 一 个 比较 完整 的 自 定义 AsyncTask 就 可 以 写成 如 下 形式 : 


class DownloadTask : AsyncTask<Unit, Int, Boolean>() { 


override fun onPreExecute() { 
progressDialog.show() // 显示 进度 对 话 框 


override fun doInBackground(vararg params: Unit?) = try { 
while (true) { 
val downloadPercent = doDownload() // 这 是 一 个 虚构 的 方法 
publishProgress (downloadPercent) 
if (downloadPercent >= 100) { 


break 
} 
} 
true 
} catch (e: Exception) { 
false 
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} 


override fun onProgressUpdate(vararg values: Int?) { 
// 在 这 里 更 新 下 载 进 度 
progressDialog.setMessage("Downloaded ${values[0]}%") 


override fun onPostExecute(result: Boolean) { 
progressDialog.dismiss()// 关闭 进度 对 话 框 
// 在 这 里 提示 下 载 结果 
if (result) { 
Toast.makeText(context, "Download succeeded", Toast.LENGTH SHORT).show() 
} else { 
Toast.makeText(context, " Download failed", Toast.LENGTH SHORT).show() 


} 


在 这 个 DownloadTask 中 ， 我们 在 doInBackground() 方 法 里 执行 具体 的 下 载 任 务 。 这 个 方法 
里 的 代码 都 是 在 子 线程 中 运行 的 ， 因 而 不 会 影响 主线 程 的 运行 。 注 意 ， 这 里 虚构 了 一 个 
doDownLoad ( ) 方 法 ， 用 于 计算 当前 的 下 载 进度 并 返回 ， 我 们 假设 这 个 方法 已 经 存在 了 。 在 得 
到 了 当前 的 下 载 进 度 后 ， 下 面 就 该 考虑 如 何 把 它 显 示 到 界面 上 了 ,由 于 doInBackground () 方 
法 是 在 子 线程 中 运行 的 ， 在 这 里 肯定 不 能 进行 Ul 操 作 ， 所 以 我 们 可 以 调用 

pubLishProg ress ( ) 方 法 并 传 入 当前 的 下 载 进度 ， 这 样 onProgressUpdate ( ) 方 法 就 会 很 
快 被 调用 ， 在 这 里 就 可 以 进行 Ul 操 作 了 。 

当下 载 完 成 后 , doInBackground ( ) 方 法 会 返回 一 个 布尔 型 变量 ,这样 onPostExecute ( ) 方 


法 就 会 很 快 被 调用 , 这 个 方法 也 是 在 主线 程 中 运行 的 。 然 后 ， 在 这 里 我 们 会 根据 下 载 的 结果 弹 
出 相应 的 Toast 提 示 , 从 而 完成 整个 DownloadTask 任 务 。 


简单 来 说 ， 使 用 AsyncTask 的 诀窍 就 是 , 在 doInBackground ( ) 方 法 中 执行 具体 的 耗 时 任务 ， 
在 onProgressUpdate() 方 法 中 进行 UI 操作 ,在 onPostExecute() 方 法 中 执行 一 些 任务 的 收 
尾 工作 。 


如 果 想 要 局 动 这 个 任务 ， 只 需 编 写 以 下 代码 即 可 : 
DownLoadTask() .execute() 


当然 ， 你 也 可 以 给 execute ( ) 方 法 传 入 任意 数量 的 参数 ， 这 些 参数 将 会 传递 到 DownloadTask 
的 doInBackground ( ) 方 法 当中 。 


以 上 就 是 AsyncTask 的 基本 用 法 ， 怎 么 样 ， 是 不 是 感觉 简单 方便 了 许多 ? 我 们 并 不 需要 去 考虑 


什么 异步 消息 处 理 机 制 ， 也 不 需要 专门 使 用 一 个 Handler 来 发 送 和 接收 消息 ， 只 需要 调用 一 下 
pubLishProgress ( ) 方 法 ， 就 可 以 轻松 地 从 子 线程 切换 到 UI 线 程 了 。 
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10.3 Service 的 基本 用 法 


了 解 了 Android 多 线程 编程 的 技术 之 后 ， 下 面 就 让 我 们 进入 本 章 的 正题 ， 开 始 对 Service 的 相关 
内 容 进行 学 习 。 作 为 Android 四 大 组 件 之 一 ，Service 也 少不了 有 很 多 非常 重要 的 知识 点 ， 那 我 
们 自然 要 从 最 基本 的 用 法 开始 学 习 了 。 


10.3.1 定义 一 个 Service 


首先 看 一 下 如 何在 项 目 中 定义 一 个 Service。 新 建 一 个 ServiceTest 项 目 ， 然 后 右 击 
com.example.servicetest>New 一 Service 一 Service ,会 弹出 如 图 10.4 所 示 的 窗口 。 


@ 0 New Android Component 


Configure Component 


人 Android Studio 


Creates a new service component and adds it to your Android 


manifest. 
Class Name: MyService 
Exported 
Enabled 
Source Language: Kotlin 


Cancel jext 
图 10.4 创建 service 的 窗口 


可 以 看 到 ,这 里 我 们 将 类 名 定义 成 MyService ,Exported 属 性 表示 是 否 将 这 个 Service 上 暴露 给 
外 部 其 他 程序 访问 ，EnabLed 属 性 表示 是 否 启用 这 个 Service。 将 两 个 属性 都 勾 中 ,点 
击 “Finish” 完 成 创建 。 


现在 观察 MyService 中 的 代码 ， 如 下 所 示 : 


class MyService : Service() { 


override fun onBind(intent: Intent): IBinder { 
TODO("Return the communication channel to the service.") 
} 
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可 以 看 到 ，MyService 是 继承 自 系统 的 Service 类 的 。 目 前 MyService 中 可 以 算是 空空 如 也 ， 
但 有 一 个 onBind ( ) 方 法 特别 醒目 。 这 个 方法 是 Service 中 唯一 的 抽象 方法 ， 所 以 必须 在 子 类 里 
实现 。 我 们 会 在 后 面 的 小 节 中 使 用 到 onBind ( ) 方 法 ,目前 可 以 暂时 将 它 忽略 。 


既然 是 定义 一 个 Service， 自然 应 该 在 Service 中 处 理 一 些 事情 了 ， 那 处 理事 情 的 逻辑 应 该 写 在 
哪里 呢 ? 这 时 就 可 以 重 写 Service 中 的 另外 一 些 方法 了 ， 如 下 所 示 : 


class MyService : Service() { 
override fun onCreate() { 


Super.onCreate() 
} 


override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int { 
return super.onStartCommand(intent, flags, startId) 
} 


override fun onDestroy() { 
super.onDestroy() 


} 


可 以 看 到 ， 这 里 我 们 又 重 写 了 onCreate()、onStartCommand( ) 和 onDestroy () 这 3 个 方 
法 ,它们 是 每 个 Service 中 最 常用 到 的 3 个 方法 了 。 其 中 onCreate() 方 法 会 在 Service 创 建 的 
时 候 调 用 , onStartCommand ( ) 方 法 会 在 每 次 Service 启 动 的 时 候 调 用 , onDestroy ( ) 方 法 
会 在 Service 销 毁 的 时 候 调用 。 


通常 情况 下 ， 如 果 我 们 希望 Service 一 旦 启动 就 立刻 去 执行 某 个 动作 ， 就 可 以 将 逻辑 写 在 
onStartCommand ( ) 方 法 里 。 而 当 Service 销 毁 时 ， 我 们 又 应 该 在 onDest roy ( ) 方 法 中 回收 
那些 不 再 使 用 的 资源 。 


另外 需要 注意 ,每 一 个 Service 都 需要 在 AndroidManifest.xml 文 件 中 进行 注册 才能 生效 。 不 
知道 你 有 没有 发 现 ， 这 是 Android 四 大 组 件 共 有 的 特点 。 不 过 相信 你 已 经 猜 到 了 ， 智 能 的 
Android Studio 早 已 自动 帮 有 我 们 完成 了 。 打 开 AndroidManifest.xmI 文 件 瞧 一 瞧 ， 代 码 如 下 所 
示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:roundIcon="@mipmap/ic launcher round" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<service 
android:name=" .MyService" 
android:enabled="true" 
android:exported="true"> 
</service> 
</application> 
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</manifest> 


这 样 的 话 ， 就 已 经 将 一 个 Service 完 全 定义 好 了 。 
10.3.2 ”启动 和 停止 Service 


定义 好 了 Service 之 后 ， 接 下 来 就 应 该 考虑 如 何 启动 以 及 停止 这 个 Service。 启 动 和 停止 的 方法 
当然 你 也 不 会 陌生 ， 主 要 是 借助 Intent 来 实现 的 。 下 面 就 让 我 们 在 ServiceTest 项 目 中 兴 试 启动 
以 及 停止 MyService。 


首先 修改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/startServiceBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Start Service" /> 


<Button 
android:id="@+id/stopServiceBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Stop Service" /> 


</LinearLayout> 


这 里 我 们 在 布局 文件 中 加 入 了 两 个 按钮 ， 分别 用 于 启动 和 停止 Service.。 
然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
startServiceBtn.setOnClickListener { 
val intent = Intent(this, MyService::class.java) 
startService(intent) // 启动 Service 
} 
stopServiceBtn.setOnClickListener { 
val intent = Intent(this, MyService::class.java) 
stopService(intent) // 停止 Service 


} 


可 以 看 到 ， 在 “Start Service" 按 钮 的 点 击 事件 里 ， 我 们 构建 了 一 个 Intent 对 象 ， 并 调用 
startService() 方 法 来 启动 MyService。 在 “Stop Service” 按 钮 的 点 击 事件 里 ， 我 们 同样 构 
建 了 一 个 Intent 对 象 ， 并 调用 stopService() 方 法 来 停止 MyService。startService() 和 


www.blogss.cn 


stopService() 方 法 都 是 定义 在 Context 类 中 的 ， 所 以 我 们 在 Activity 里 可 以 直接 调用 这 两 个 
方法 。 另 外 ,Service 也 可 以 自我 停止 运行 ， 只 需要 在 Service 内 部 调用 stopSeLf ( ) 方 法 即 
可 。 

那么 接 下 来 又 有 一 个 问题 需要 思考 了 ， 我 们 如 何 才 能 证 实 Service 已 经 成 功 启动 或 者 停止 了 呢 ? 
最 简单 的 方法 就 是 在 MyService 的 几 个 方法 中 加 入 打印 日 志 ，, 如 下 所 示 : 


class MyService : Service() { 


override fun onCreate() { 
super.onCreate() 


Log.d("MyService", "onCreate executed") 

} 

override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int { 
Log.d("MyService", "onStartCommand executed") 
return super.onStartCommand(intent, flags, startId) 

} 


override fun onDestroy() { 
super.onDestroy() 
Log.d("MyService", "onDestroy executed") 


} 
现在 可 以 运行 一 下 程序 来 进行 测试 了 ， 程序 的 主 界面 如 图 10.5 所 示 。 
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1:48 pa | 


ServiceTest 
START SERVICE 


STOP SERVICE 


图 10.5 ServiceTest 的 主 界面 
点 击 一 下 “Start Service" 按 钮 , 观察 Logcat 中 的 打印 日 志 , 如 图 10.6 所 示 。 


com.example.servicetest (19267) Verbose “ 豆 Qr 


267/com.example.servicetest D/MyService: onCreate executed 
267/com.example,.servicetest D/MyService: onStartCommand executed 


图 10.6 ”启动 Service 时 的 打印 日 志 


MyService 中 的 onCreate( ) 和 onStartCommand() 方 法 都 执行 了 ， 说明 这 个 Service 确 实 已 
经 启动 成 功 了 ， 并 且 你 还 可 以 在 Settings-SystemAdvancedDeveloper 
options=Running services 中 找到 它 (不 同 手 机 路 径 可 能 不 同 ， 也 有 可 能 无 此 选项 ) ， 如 图 
10.7 所 示 。 
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1:56 > 自 


€ Running services : 


Device memory 


国 System 1.4 GB of RAM 
国 Apps 08 MB of RAM 

Free 1.9 GB of RAM 
App RAM usage 


Settings 127 MB 


1 process and 0 services 


erviceTest 31MB 


process and 1 service 00:28 


Android System 4.9 MB 


1 process and 1 service 15:45:29 


Bluetooth 14 MB 
1 process and 11 services 136:01:48 
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图 10.7 正在 运行 的 Service 列 表 
然后 再 点 击 一 下 Stop Service” 按 钮 ,观察 Logcat 中 的 打印 日 志 ，, 如 图 10.8 所 示 。 


com.example.servicetest (19267) Verbose “地 Qr 


267/com. example. servicetest D/MyService: onDestroy executed 
图 10.8 停止 Service 时 的 打印 日 志 
由 此 证 明 ,MyService 确 实 已 经 成 功 停止 下 来 了 。 
以 上 就 是 Service 启 动 和 停止 的 基本 用 法 ,但 是 从 Android 8.0 系 统 开始 ， 应 用 的 后 台 功能 被 大 


幅 肖 | 碱 。 现 在 只 有 当 应 用 保持 在 前 台 可 见 状态 的 情况 下 ,Service 才 能 保证 稳定 运行 ， 一旦 应 用 
进入 后 台 之 后 ，Service 随 时 都 有 可 能 被 系统 回收 。 之 所 以 做 这 样 的 改动 ， 是 为 了 防止 许多 恶意 
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的 应 用 程序 长 期 在 后 台 占 用 手机 资源 ， 从 而 导致 手机 变 得 越 来 越 卡 。 当 然 ， 如 果 你 真 的 非常 需 
要 长 期 在 后 台 执行 一 些 任务 ， 可 以 使 用 前 台 Service 或 者 WorkManager， 前 台 Service 我 们 待 
会 马上 就 会 学 到 ,而 WorkManager 将 会 在 第 13 章 中 进行 学 习 。 


回 到 正题 ， 虽 然 我 们 已 经 学 会 了 启动 和 停止 Service 的 方法 ， 但 是 不 知道 你 心里 现在 有 没有 一 个 
疑惑 ， 那 就 是 onCreate () 方 法 和 onStartCommand ( ) 方 法 到 底 有 什么 区 别 呢 ? 因为 刚刚 点 
击 “Start Service" 按 钮 后 ， 两 个 方法 都 执行 了 。 


其 实 onCreate ( ) 方 法 是 在 Service 第 一 次 创建 的 时 候 调 用 的 ,而 onStartCommand ( ) 方 法 则 
在 每 次 局 动 Service 的 时 候 都 会 调用 。 由 于 刚才 我 们 是 第 一 次 点 击 “Start Service" 按 钮 ， 
Service 此 时 还 未 创建 过 ， 所 以 两 个 方法 都 会 执行 ， 之 后 如 果 你 再 连续 多 点 击 几 次 “Start 
Service" 按 钮 ， 你 就 会 发 现 只 有 onStartCommand ( ) 方 法 可 以 得 到 执行 了 。 


10.3.3 ” Activity 和 Service 进 行 通信 


在 上 一 小 节 中 ， 我 们 学 习 了 启动 和 停止 Service 的 方法 。 不 知道 你 有 没有 发 现 ， 虽 然 Service 是 
在 Activity 里 启动 的 ， 但 是 在 启动 了 Service 之 后 , Activity 与 Service 基 本 就 没有 什么 关系 了 。 
确实 如 此 ， 我 们 在 Activity 里 调用 了 startService() 方 法 来 启动 MyService， 然 后 
MyService 的 onCreate() 和 onStartCommand ( ) 方 法 就 会 得 到 执行 。 之 后 Service 会 一 直 处 
于 运行 状态 ， 但 具体 运行 的 是 什么 逻辑 ，Activity 就 控制 不 了 了 。 这 就 类 似 于 Activity 通 知 了 
Service 一 下 :“ 你 可 以 局 动 了 ! “然后 service 就 去 忙 自己 的 事情 了 ， 但 Activity 并 不 知道 
Service 到 底 做 了 什么 事情 ， 以 及 完成 得 如 何 。 


那么 可 不 可 以 让 Activity 和 Service 的 关系 更 紧密 一 些 呢 ? 例如 在 Activity 中 指挥 Service 去 干 什 
么 ,Service 就 去 干什么 。 当 然 可 以 ， 这 就 需要 借助 我 们 刚刚 名 略 的 onBind ( ) 方 法 了 。 


比如 说 ， 目 前 我 们 希望 在 MyService 里 提供 一 个 下 载 功 能 ， 然 后 在 Activity 中 可 以 决定 何 时 开始 
下 载 ， 以 及 随时 查看 下 载 进度 。 实 现 这 个 功能 的 思路 是 创建 一 个 专门 的 Binde r 对 象 来 对 下 载 功 
能 进行 管理 。 修 改 MyService 中 的 代码 ， 如 下 所 示 : 


class MyService : Service() { 
private val mBinder = DownloadBinder() 
class DownloadBinder : Binder() { 
fun startDownload() { 


Log.d("MyService", "startDownload executed") 


fun getProgress(): Int { 
Log.d("MyService", "getProgress executed") 
return 0 


} 
} 
override fun onBind(intent: Intent): IBinder { 


return mBinder 


} 
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可 以 看 到 ， 这 里 我 们 新 建 了 一 个 DownLoadBinder 类 ， 并 让 它 继 承 自 Binder ,然后 在 它 的 内 
部 提供 了 开始 下 载 以 及 查看 下 载 进度 ee 当然 这 只 是 两 个 模拟 方法 ， 并 没有 实现 真正 的 功 
能 ， 我 们 在 这 两 个 方法 中 分 别 打印 了 一 行 日 志 。 


接着 ， 在 MyService 中 创建 了 DownLoadBinder 的 实例 ， 然 后 在 onBind ( ) 方 法 里 返回 了 这 个 
实例 , 这 样 MyService 中 的 工作 就 全 部 完成 了 。 


下 面 就 要 看 一 看 在 Activity 中 如 何 调用 Service 里 的 这 些 方法 了 。 首 先 需要 在 布局 文件 里 新 增 两 
个 按钮 ， 修 改 activity_ main.xml 中 的 代码 , 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/bindServiceBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Bind Service" /> 


<Button 
android:id="@+id/unbindServiceBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Unbind Service" /> 


</LinearLayout> 


这 两 个 按钮 分 别 是 用 于 绑 定 和 取消 绑 定 Service 的 ， 那 到 底 谁 需要 和 Service 绑 定 呢 ? 当然 就 是 
Activity 了 。 当 一 个 Activity 和 Service 绑 定 了 之 后 ， 就 可 以 调用 该 Service 里 的 Binder 提 供 的 
方法 了 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
lateinit var downloadBinder: MyService.DownloadBinder 
private val connection = object : ServiceConnection { 
override fun onServiceConnected(name: ComponentName, service: IBinder) { 
downloadBinder = service as MyService.DownloadBinder 
downLoadBinder.startDowntLoad ( ) 
downloadBinder.getProgress() 


} 


override fun onServiceDisconnected(name: ComponentName) { 


} 

} 

override fun onCreate(savedInstanceState: Bundle?) { 
bindServiceBtn.setonClickListener { 


val intent = Intent(this, MyService::class.java) 
bindService(intent, connection, Context.BIND AUTO CREATE) // 绑 定 Service 
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unbindServiceBtn.setOnClickListener { 
unbindService(connection) // 解 绑 Service 
} 
+ 


} 


这 里 我 们 首先 创建 了 一 个 ServiceConnection 的 匿名 类 实现 ， 并 在 里 面 重 写 了 
onServiceConnected() 方 法 和 onServiceDisconnected() 方 法 。 
onServiceConnected () 方 法 方法 会 在 Activity 与 Service 成 功 绑 定 的 时 候 调 用 ， 而 
onServiceDisconnected () 方 法 只 有 在 Service 的 创建 进程 月 溃 或 者 被 杀 掉 的 时 候 才 会 调 
用 ， 这 个 方法 不 太 常用 。 那 么 在 onServiceConnected () 方 法 中 ， 我 们 又 通过 向 下 转型 得 到 
了 DownLoadBinder 的 实例 ,有 了 这 个 实例 ,Activity 和 Service 之 间 的 关系 就 变 得 非常 紧密 
了 。 现 在 我 们 可 以 在 Activity 中 根据 具体 的 场景 来 调用 DownLoadBinder 中 的 任何 pubLic 方 
法 ， 即 实现 了 指挥 Service 干 什么 Service 就 去 干什么 的 功能 。 这 里 仍然 只 是 做 了 个 简单 的 测 
试 ， 在 onServiceConnected () 方 法 中 调用 了 DownLoadBinder 的 startDowntLoad ( ) 和 
getProgress() 方 法 。 


当然 ， 现 在 Activity 和 Service 其 实 还 没 进行 绑 定 呢 ， 这 个 功能 是 在 “Bind Service" 按 钮 的 点 击 
事件 里 完成 的 。 可 以 看 到 ， 这 里 我 们 仍然 构建 了 一 个 Intent 对 象 ， 然 后 调用 bindService() 方 
法 将 MainActivity 和 MyService 进 行 绑 定 。bindService( ) 方 法 接收 3 个 参数 ， 第 一 个 参数 就 
是 刚刚 构建 出 的 Intent 对 象 ， 第 二 个 参数 是 前 面 创建 出 的 ServiceConnection 的 实例 , 第 三 
个 参数 则 是 一 个 标志 位 ， 这 里 传 和 BIND_AUT0_CREATE 表 示 在 Activity 和 Service 进 行 绑 定 后 
自动 创建 Service。 这 会 使 得 MyService 中 的 onCreate ( ) 方 法 得 到 执行 ， 但 
onStartCommand () 方 法 不 会 执行 。 


如 果 我 们 想 解 除 Activity 和 Service 之 间 的 绑 定 该 怎么 办 呢 ? 调用 一 下 unbindService() 方 法 
就 可 以 了 ， 这 也 是 “Unbind Service” 按 钮 的 点 击 事件 里 实现 的 功能 ，。 


现在 让 我 们 重新 运行 一 下 程序 吧 , 界面 如 图 10.9 所 示 。 
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9:09 


ServiceTest 


START SERVICE 
STOP SERVICE 
BIND SERVICE 


UNBIND SERVICE 


图 10.9 ServiceTest 新 的 主 界面 
点 击 一 下 “Bind Service" 按 钮 ,观察 Logcat 中 的 打印 日 志 ，, 如 图 10.10 所 示 。 


com.example.servicetest (30991) Verbose “二 Qr 


991/com.example.servicetest D/MyService: onCreate executed 
991/com.example.servicetest D/MyService: startDownload executed 
991/com.example,.servicetest D/MyService: getProgress executed 


图 10.10 绑 定 Service 时 的 打印 日 志 


可 以 看 到 ， 首 先是 MyService 的 onCreate ( ) 方 法 得 到 了 执行 ， 然 后 startDownLoad ( ) 和 
getProgress ( ) 方 法 都 得 到 了 执行 ， 说 明 我 们 确实 已 经 在 Activity 里 成 功 调用 了 Service 里 提 
供 的 方法 。 
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另外 需要 注意 ， 任何 一 个 Service 在 整个 应 用 程序 范围 内 都 是 通用 的 ， 即 MyService 不 仅 可 以 和 
MainActivity 绑 定 ， 还 可 以 和 任何 一 个 其 他 的 Activity 进 行 绑 定 ， 而 且 在 绑 定 完成 后 ， 它 们 都 可 
以 获取 相同 的 DownLoadBinder 实 例 。 
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10.4 Service 的 生命 周期 


之 前 我 们 学 习 过 了 Activity 以 及 Fragment 的 生命 周期 。 类 似 地 ，Service 也 有 自己 的 生命 质 
期 ， 前 面 我 们 使 用 到 的 onCreate()、onStartCommand()、onBind() 和 onDestroy () 等 
方法 都 是 在 Service 的 生命 周期 内 可 能 回调 的 方法 。 


一 旦 在 项 目的 任何 位 置 调用 了 Context 的 startService() 方 法 ， 相 应 的 Service 就 会 启动 ， 
并 回调 onStartCommand ( ) 方 法 。 如 果 这 个 Service 之 前 还 没有 创建 过 ,onCreate ( ) 方 法 会 
先 于 onStartCommand ( ) 方 法 执行 。Service 启 动 了 之 后 会 一 直 保持 运行 状态 ， 直 到 | 
stopService() 或 stopSeLf( ) 方 法 被 调用 ， 或 者 被 系统 回收 。 注 意 ， 虽 然 每 调用 一 次 
startService() 方 法 ,onStartCommand ( ) 就 会 执行 一 次 ,但 实际 上 每 个 Service 只 会 存在 
一 个 实例 。 所 以 不 管 你 调用 了 多 少 次 startService() 方 法 ,只 需 调用 一 次 stopService( ) 
或 stopSelf() 方 法 ,Service 就 会 停止 。 


另外 ，, 还 可 以 调用 Context 的 bijndService( ) 来 获取 一 个 Service 的 持久 连接 ， 这 时 就 会 回调 
Service 中 的 onBind() 方 法 。 类 似 地 ,如 果 这 个 Service 之 前 还 没有 创建 过 ，onCreate() 方 
法 会 先 于 onBind ( ) 方 法 执行 。 之 后 ， 调 用 方 可 以 获取 到 onBind ( ) 方 法 里 返回 的 ILBinder 对 象 
的 实例 ， 这样 就 能 自由 地 和 Service 进 行 通信 了 。 只 要 调用 方 和 Service 之 间 的 连接 没有 断 开 ， 
Service 就 会 一 直 保 持 运行 状态 ， 直 到 被 系统 回收 。 


当 调用 了 startService() 方 法 后 , 再 去 调用 stopService() 方 法 。 这 时 Service 中 的 
onDestroy () 方 法 就 会 执行 ， 表 示 Service 已 经 销毁 了 。 类 似 地 ， 当 调用 了 bindService() 
方法 后 ， 再 去 调用 unbindService() 方 法 ,onDestroy() 方 法 也 会 执行 ,这 两 种 情况 都 很 好 
理解 。 但 是 需要 注意 ， 我们 是 完全 有 可 能 对 一 个 Service 既 调用 了 startService() 方 法 ,又 
调用 了 bindService() 方 法 的 ,在 这 种 情况 下 该 如 何 让 Service 销 毁 呢 ? 根据 Android 系 统 的 
机 制 ， 一 个 Service 只 要 被 启动 或 者 被 绑 定 了 之 后 ， 就 会 处 于 运行 状态 ， 必 须要 让 以 上 两 种 条 件 
同时 不 满足 ，Service 才 能 被 销毁 。 所 以 ， 这 种 情况 下 要 同时 调用 stopService( ) 和 
unbindService() 方 法 , onDestroy() 方 法 才 会 执行 。 


这 样 你 就 把 Service 的 生命 周期 完整 地 走 了 一 遍 。 
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10.5 Service 的 更 多 技巧 


以 上 所 学 的 内 容 都 是 关于 Service 最 基本 的 一 些 用 法 和 概念 ， 当 然 也 是 最 常用 的 。 不 过 ， 仅仅 满 
足 于 此 显然 是 不 够 的 ， 关 于 Service 的 更 多 高 级 使 用 技巧 还 在 等 着 我 们 呢 ,下面 就 赶快 去 看 一 看 
吧 。 


10.5.1 使 用 前 台 Service 


前 面 已 经 说 过 , 从 Android 8.0 系 统 开始 ,只 有 当 应 用 保持 在 前 台 可 见 状态 的 情况 下 ，Service 
才能 保证 稳定 运行 ,一旦 应 用 进入 后 台 之 后 ，Service 随 时 都 有 可 能 被 系统 回收 。 而 如 果 你 希望 
Service 能 够 一 直 保持 运行 状态 ， 就 可 以 考虑 使 用 前 台 Service。 前 台 Service 和 普通 Service 最 
大 的 区 别 就 在 于 ， 它 一 直 会 有 一 个 正在 运行 的 图 标 在 系统 的 状态 栏 显示 ， 下 拉 状 态 栏 后 可 以 看 
到 更 加 详细 的 信息 ， 非 常 类 似 于 通知 的 效果 ， 如 图 10.11 所 示 。 


27° Cloudy 
您, Cloudy here but is raining SW 29 km away 
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图 10.11 前 台 Service 的 效果 


由 于 状态 栏 中 一 直 有 一 个 正在 运行 的 图 标 ， 相 当 于 我 们 的 应 用 以 另外 一 种 形式 保持 在 前 台 可 见 
状态 ， 所 以 系统 不 会 倾向 于 回收 前 台 Service。 另 外 ， 用 户 也 可 以 通过 下 拉 状 态 栏 清楚 地 知道 当 
前 什么 应 用 正在 运行 ， 因 此 也 不 存在 某 些 恶意 应 用 长 期 在 后 台 偷偷 占用 手机 资源 的 情况 。 


那么 我 们 就 来 看 一 下 如 何 才能 创建 一 个 前 台 Service 吧 ， 其 实 并 不 复杂 ， 修改 MyService 中 的 代 
码 ， 如 下 所 示 : 


class MyService : Service() { 


override fun onCreate() { 

super.onCreate() 

Log.d("MyService", "onCreate executed") 

val manager = getSystemService(Context.NOTIFICATION SERVICE) as 

NotificationManager 

if (Build.VERSION.SDK INT >= Build.VERSION CODES.0) { 

val channel = NotificationChannel("my_service", "前 台 Service 通 知 "， 
NotificationManager.IMPORTANCE DEFAULT) 

manager.createNotificationChannel (channel) 


val intent = Intent(this, MainActivity::class.java) 

val pi = PendingIntent.getActivity(this, 0, intent, 0) 

val notification = NotificationCompat.Builder(this, "my service") 
.SetContentTitle("This is content title") 
.SetContentText("This is content text") 
.SetSmallIcon(R.drawable.small icon) 
.SetLargelcon(BitmapFactory.decodeResource(resources, R.drawable.large icon)) 
.SetContentIntent(pi) 
.build!() 

startForeground(1, notification) 


} 


可 以 看 到 ， 这 里 只 是 修改 了 onCreate() 方 法 中 的 代码 ， 相信 这 部 分 代码 你 会 非常 眼熟 。 没 

错 ! 这 就 是 我 们 在 第 9 章 中 学 习 的 创建 通知 的 方法 ， 并 且 我 还 将 small_icon 和 large_icon 这 两 
张 图 从 NotificationTest 项 目 中 复制 了 过 来 。 只 不 过 这 次 在 构建 Notification 对 象 后 并 没有 使 
用 NotificationManager 将 通知 显示 出 来 ， 而 是 调用 了 startForeground() 方 法 。 这 个 方法 
接收 两 个 参数 : 第 一 个 参数 是 通知 的 id， 类 似 于 notify( ) 方 法 的 第 一 个 参数 ; 第 二 个 参数 则 是 
构建 的 Notification 对 象 。 调 用 startForeground ( ) 方 法 后 就 会 让 MyService 变 成 一 个 前 
台 Service，, 并 在 系统 状态 栏 显 示 出 来 。 


另外 , 从 Android 9.0 系 统 开始 ,使 用 前 台 Service 必 须 在 AndroidManifest.xml 文 件 中 进行 权 
限 声明 才 行 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 
<uses-permission android:name="android.permission.FOREGROUND SERVICE" /> 


</manifest> 


现在 重新 运行 一 下 程序 ， 并 点 击 “Start Service" 按 钮 ，MyService 就 会 以 前 台 Service 的 模式 
局 动 了 ， 并 且 在 系统 状态 栏 会 显示 一 个 通知 图 标 ， 下 拉 状 态 栏 后 可 以 看 到 该 通知 的 详细 内 容 ， 
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如 图 10.12 所 示 。 


Mon, Aug 19 a 100% 


O00o° 


咀 ' ServiceTest * now 


This is content title 
This is content text 
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图 10.12 前 台 Service 的 状态 栏 效 果 

现在 即使 你 退出 应 用 程序 , MyService 也 会 一 直 处 于 运行 状态 ,而且 不 用 担心 会 被 系统 回收 。 
当然 ，MyService 所 对 应 的 通知 也 会 一 直 显 示 在 状态 栏 上 面 。 如 果 用 户 不 希望 我 们 的 程序 一 直 
运行 ， 也 可 以 选择 手动 杀 掉 应 用 ,这样 MyService 就 会 跟着 一 起 停止 运行 了 。 


前 台 Service 的 用 法 就 这 么 简单 ， 只 要 你 在 第 9 章 中 将 通知 的 用 法 掌握 好 了 ， 学习 本 节 的 知识 一 
定 会 特别 轻松 。 


10.5.2 使 用 IntentService 


话说 回来 ， 在 本 章 一 开始 的 时 候 我 们 就 已 经 知道 ，Service 中 的 代码 都 是 默认 运行 在 主线 程 当中 
的 ， 如 果 直 接 在 Service 里 处 理 一 些 耗 时 的 逻辑 ， 就 很 容易 出 现 ANR (Application Not 


www.blogss.cn 


Responding) 的 情况 。 

所 以 这 个 时 候 就 需要 用 到 Android 多 线程 编程 的 技术 了 ， 我 们 应 该 在 Service 的 每 个 具体 的 方法 
里 开局 一 个 子 线程 ， 然 后 在 这 里 处 理 那 些 耗 时 的 逻辑 。 因 此 ,一 个 比较 标准 的 Service 就 可 以 写 
成 如 下 形式 : 


class MyService : Service() { 


override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int { 


thread { 
// 处 理 具体 的 逻辑 


return super.onStartCommand(intent, flags, startId) 


} 
但 是 ,这 种 Service 一 旦 启动 ,就 会 一 直 处 于 运行 状态 ,必须 调用 stopService() 或 
stopSelf() 方 法 ,或 者 被 系统 回收 ,Service 才 会 停止 。 所 以 ， 如 果 想 要 实现 让 一 个 Service 
在 执行 完毕 后 自动 停止 的 功能 ,就 可 以 这 样 写 : 


class MyService : Service() { 


override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int { 


thread { 
// 处 理 具体 的 逻辑 
stopSelf() 

} 


return super.onStartCommand(intent, flags, startId) 


} 


虽说 这 种 写法 并 不 复杂 ,但 是 总 会 有 一 些 程序 员 忘 记 开 启 线程 ， 或 者 忘记 调用 stopSelf() 方 
法 。 为 了 可 以 简单 地 创建 一 个 异步 的 、 会 自动 停止 的 Service , Android 专 门 提 供 了 一 个 
IntentService 类 ， 这 个 类 就 很 好 地 解决 了 前 面 所 提 到 的 两 种 敌 傣 ,下 面 我 们 就 来 看 一 下 它 的 用 


法 。 
新 建 一 个 MylntentService 类 继承 自 IntentService， 代 码 如 下 所 示 : 


class MyIntentService : IntentService("MyIntentService") { 


override fun onHandleIntent(intent: Intent?) { 
// 打印 当前 线程 的 id 


Log.d("MyIntentService", "Thread id is ${Thread.currentThread().name}") 


override fun onDestroy() { 
super.onDestroy() 
Log.d("MyIntentService", "onDestroy executed") 


} 


这 里 首先 要 求 必 须 先 调用 父 类 的 构造 函数 ， 并 传 入 一 个 字符 串 ， 这 个 字符 串 可 以 随意 指定 ， 只 
在 调试 的 时 候 有 用 。 然 后 要 在 子 类 中 实现 onHandLeIntent ( ) 这 个 抽象 方法 ， 这 个 方法 中 可 以 
处 理 一 些 耗 时 的 逻辑 ， 而 不 用 担心 ANR 的 问题 ， 因 为 这 个 方法 已 经 是 在 子 线程 中 运行 的 了 。 这 
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里 为 了 证 实 一 下 ,我 们 在 onHandtLeIntent ( ) 方 法 中 打印 了 当前 线程 名 。 另 外 ,根据 
IntentService 的 特性 ， 这 个 Service 在 运行 结束 后 应 该 是 会 自动 停止 的 ， 所 以 我 们 又 重 写 了 
onDestroy () 方 法 ,在 这 里 也 打印 了 一 行 日 志 ，, 以 证 实 Service 是 不 是 停止 了 。 


接 下 来 修改 activity_ main.Xxml 中 的 代码 ,加 入 一 个 用 于 局 动 MylntentService 的 按钮 ， 如 下 
所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/startIintentServiceBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Start IntentService" /> 


</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ,如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


startIntentServiceBtn.setOnClickListener { 
// 打印 主线 程 的 id 
Log.d("MainActivity", "Thread id is ${Thread.currentThread().name}") 
val intent = Intent(this, MyIntentService::class.java) 
startService(intent) 


} 


可 以 看 到 ,我们 在 “Start IntentService”" 按 钮 的 点 击 事件 里 启动 了 MylintentService ,并 在 这 
里 打印 了 一 下 主线 程 名 ， 稍 后 用 于 和 IntentService 进 行 比 对 。 你 会 发 现 ， 其 实 IntentService 
的 启动 方式 和 普通 的 Service 没 什么 两 样 。 


最 后 不 要 忘记 ,Service 都 是 需要 在 AndroidManifest.xml 里 注册 的 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.servicetest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:roundIcon="@mipmap/ic launcher round" 
android:label="@string/app_name" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<service 
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android:name=".MyIntentService" 
android:enabled="true" 
android:exported="true"/> 


</application> 


</manifest> 
当然 ， 你 也 可 以 使 用 Android Studio 提 供 的 快捷 方式 来 创建 IntentService ,不 过 由 于 这 样 会 
自动 生成 一 些 我 们 用 不 到 的 代码 ， 因 此 这 里 我 采用 了 手动 创建 的 方式 。 

现在 重新 运行 一 下 程序 , 界面 如 图 10.13 所 示 。 


10:41 


ServiceTest 


START SERVICE 
STOP SERVICE 
BIND SERVICE 

UNBIND SERVICE 


START INTENTSERVICE 


图 10.13 ServiceTest 更 新 后 的 主 界面 
点 击 “Start IntentService” 按 钮 后 , 观察 Logcat 中 的 打印 日 志 , 如 图 10.14 所 示 。 
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com.example.servicetest (13701) Verbose | Qr 


701/com,exampLe.servicetest D/MainActivity: Thread id is main 
628/com.example.servicetest D/MyIntentService: Thread id is IntentService[MyIntentService] 


701/com.example,.servicetest D/MyIntentService: onDestroy executed 


图 10.14 ”启动 IntentService 时 的 打印 日 志 


可 以 看 到 ,不仅 MylIntentService 和 MainActivity 所 在 的 线程 名 不 一 样 ， 而 且 onDestroy() 方 
法 也 得 到 了 执行 ,说明 MylintentService 在 运行 完毕 后 确实 自动 停止 了 。 集 开启 线程 和 自动 停 
止 于 一 身 ，IntentService 还 是 博得 了 不 少 程序 员 的 喜爱 。 

好 了 ， 关 于 Service 的 知识 点 你 已 经 学 得 够 多 了 ， 下面 依照 惯例 ， 就 让 我 们 进入 本 章 的 Kotlin 课 
堂 吧 。 
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10.6 ”Kotlin 课 堂 : 泛 型 的 高 级 特性 


还 记得 在 第 8 章 的 Kotlin 课 堂 里 我 们 学 习 的 Kotlin 泛 型 的 基本 用 法 吗 ? 这 些 基本 用 法 其 实 和 java 
中 泛 型 的 用 法 是 大 致 相同 的 ， 因 此 也 相对 比较 好 理解 。 然 而 实际 上 ，Kotlin 在 泛 型 方面 还 提供 了 
不 少 特有 的 功能 ,掌握 了 这 些 功能 ， 你 将 可 以 更 好 玩 转 Kotlin， 同 时 还 能 实现 一 些 不 可 思议 的 语 
法 特性 ， 那么 我 们 自然 不 能 错过 这 部 分 内 容 了 。 


10.6.1 对 泛 型 进行 实 化 


泛 型 实 化 这 个 功能 对 于 绝 大 多 数 java 程 序 员 来 讲 是 非常 陌生 的 ， 因 为 java 中 完全 没有 这 个 概 
念 。 而 如 果 我 们 想 要 深刻 地 理解 泛 型 实 化 ， 就 要 先 解释 一 下 java 的 泛 型 擦 除 机 制 才 行 。 


在 JjDK 1.5 之 前 ，jJava 是 没有 泛 型 功能 的 ， 那 个 时 候 诸 如 List 之 类 的 数据 结构 可 以 存储 任意 类 型 
的 数据 ， 取 出 数据 的 时 候 也 需要 于 动向 下 转型 才 行 ， 这 不 仅 麻 烦 ， 而 且 很 危险 。 比 如 说 我 们 在 
同一 个 List 中 存储 了 字符 串 和 整 型 这 两 种 数据 ， 但 是 在 取出 数据 的 时 候 却 无 法 区 分 具体 的 数据 类 
型 ， 如 果 手 动 将 它们 强制 转 成 同一 种 类 型 ， 那 么 就 会 抛 出 类 型 转换 异常 。 


于 是 在 jDK 1.5 中 ,java 终于 引入 了 泛 型 功能 。 这 不 仅 让 诸如 List 之 类 的 数据 结构 变 得 简单 好 
用 ， 也 让 我 们 的 代码 变 得 更 加 安全 。 


但 是 实际 上 ,java 的 泛 型 功能 是 通过 类 型 探 除 机 制 来 实现 的 。 什 么 意思 呢 ? 就 是 说 泛 型 对 于 类 
型 的 约束 只 在 编译 时 期 存在 ,运行 的 时 候 仍然 会 按照 /DK 1.5 之 前 的 机 制 来 运行 ，JVM 是 识别 不 
出 来 我 们 在 代码 中 指定 的 泛 型 类 型 的 。 例 如 ， 假设 我 们 创建 了 一 个 List<String> 集 合 ， 虽 然 
在 编译 时 期 只 能 向 集合 中 添加 字符 串 类 型 的 元 素 ， 但 是 在 运行 时 期 |VM 并 不 能 知道 尼 本 来 只 打算 
包含 哪 种 类 型 的 元 素 ， 只 能 识别 出 来 它 是 个 List。 


所 有 基于 JVM 的 语言 ,它们 的 泛 型 功能 都 是 通过 类 型 擦 除 机 制 来 实现 的 ， 其 中 当然 也 包括 了 
Kotlin。 这 种 机 制 使 得 我 们 不 可 能 使 用 a is T 或 者 T: :class. java 这 样 的 语法 ， 因 为 T 的 实际 
类 型 在 运行 的 时 候 已 经 被 擦 除了 。 


然而 不 同 的 是 ，Kotlin 提 供 了 一 个 内 联 函 数 的 概念 ， 我 们 在 第 6 章 的 Kotlin 课 堂 中 已 经 学 过 了 这 
个 知识 点 。 内 联 函 数 中 的 代码 会 在 编译 的 时 候 自动 被 替换 到 调用 它 的 地 方 ， 这 样 的 话 也 就 不 存 
在 什么 泛 型 控 除 的 问题 了 ， 因 为 代码 在 编译 之 后 会 直接 使 用 实际 的 类 型 来 替代 内 联 函 数 中 的 泛 
型 声明 , 其 工作 原理 如 图 10.15 所 示 。 


fun foo() { 


bar<String>()|s 


} 


inline fun <T> bar() { 


// do something with T type 


} 


图 10.15 内 联 函数 的 代码 替换 过 程 
最 终 代 码 会 被 替换 成 如 图 10.16 所 示 的 样子 。 
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fun foo() { 
// do something with String type 


} 


图 10.16 车 换 完成 后 的 代码 


可 以 看 到 ，bar( ) 是 一 个 带 有 泛 型 类 型 的 内 联 函 数 ，foo ( ) 函数 调用 了 bar ( ) 组 数 ， 在 代码 编 

译 之 后 , bar( ) 函 数 中 的 代码 将 可 以 获得 泛 型 的 实际 类 型 。 

这 就 意味 着 ，Kotlin 中 是 可 以 将 内 联防 数 中 的 泛 型 进行 实 化 的 。 

那么 具体 该 怎么 写 才 能 将 泛 型 实 化 呢 ? 首先 ,该 水 数 必须 是 内 联 了 水 数 才 行 ， 也 就 是 要 用 inline 
关键 字 来 修饰 该 函数 。 其 次 ， 在 声明 泛 型 的 地 方 必须 加 上 reified 关 键 字 来 表示 该 泛 型 要 进行 
实 化 。 示 例 代码 如 下 : 


inline fun <reified T> getGenericType() { 


上 述 函 数 中 的 泛 型 T 就 是 一 个 被 实 化 的 泛 型 ， 因 为 它 满足 了 内 联 函 数 和 reified 关 键 字 这 两 个 前 
提 条 件 。 那 么 借助 泛 型 实 化 ， 到 底 可 以 实现 什么 样 的 效果 呢 ? 从 函数 名 就 可 以 看 出 来 了 ， 这 里 
我 们 准备 实现 一 个 获取 泛 型 实际 类 型 的 功能 ， 代 码 如 下 所 示 : 


inline fun <reified T> getGenericType() = T::class.java 


虽然 只 有 一 行 代码 ,但 是 这 里 却 实 现 了 一 个 java 中 完全 不 可 能 实现 的 功能 : 
getGenericType() 函 数 直接 返回 了 当前 指定 泛 型 的 实际 类 型 。T. cLass 这 样 的 语法 在 java 
中 是 不 合法 的 ， 而 在 Kotlin 中 ， 借 助 泛 型 实 化 功能 就 可 以 使 用 T: :class . java 这样 的 语法 了 。 


现在 我 们 可 以 使 用 如 下 代码 对 getGene ricType ( ) 水 数 进行 测试 : 


fun main() { 
val resulLt1 = getGenericType<String>() 
val result2 = getGenericType<Int>() 
printLn("resuLt1 is $result1") 
println("result2 is $result2") 


} 


这 里 给 getGenericType() 电 数 指定 了 两 种 不 同 的 泛 型 ,由 于 getGenericType( ) 水 数 会 将 
指定 泛 型 的 具体 类 型 返回 ， 因 此 这 里 我 们 将 返回 的 结果 进行 打印 。 


现在 运行 一 人 main( ) 潍 数 ， 结果 如 图 10.17 所 示 。 


Run: © com.example.servicetest.ReifiedKt 

"/Applications/Android Studio.app/Contents/jre/ijdk/Contents/Home/bin/java" ... 
resultl1 is class java,. lang.String 

result2 is class java,Lang,Integer 


Pp 


三 Process finished with exit code 0 


图 10.17 泛 型 实 化 功能 的 运行 结果 
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可 以 看 到 ， 如 果 将 泛 型 指定 成 了 St ring，, 那么 就 可 以 得 到 java.Lang.String 的 类 型 ; 如 果 
将 泛 型 指定 了 Int ,就 可 以 得 到 java .Lang .Integer 的 类 型 。 


关于 泛 型 实 化 的 基本 用 法 就 介绍 到 这 里 ， 接 下 来 我 们 看 一 看 ， 泛 型 实 化 在 Android 项 目 当中 具体 
可 以 有 哪些 应 用 。 


10.6.2 泛 型 实 化 的 应 用 


泛 型 实 化 功能 允许 我 们 在 泛 型 水 数 当 中 获得 泛 型 的 实际 类 型 ， 这 也 就 使 得 类 似 于 a is TT、 
T: :Class.java 这 样 的 语法 成 为 了 可 能 。 而 灵活 运用 这 一 特性 将 可 以 实现 一 些 不 可 思议 的 语法 
结构 ， 下 面 我 们 赶快 来 看 一 下 吧 。 


到 目前 为 止 ,我 们 已 经 将 Android 的 四 大 组 件 全 部 学 完了 ， 除 了 ContentProvider 之 外 ， 你 会 
发 现 其 余 的 3 个 组 件 有 一 个 共同 的 特点 ， 它们 都 是 要 结合 Intent 一 起 使 用 的 。 比 如 说 启动 一 个 
Activity 就 可 以 这 么 写 


val intent = Intent(context, TestActivity::class.java) 
context.startActivity(intent) 


有 没有 觉得 TestActivity: :class.java 这 样 的 语法 很 难受 呢 ? 当然 ， 如 果 在 没有 更 好 选择 
的 情况 下 ， 这 种 写法 也 是 可 以 忍受 的 ， 但 是 Kotlin 的 泛 型 实 化 功能 使 得 我 们 拥有 了 更 好 的 选择 。 


新 建 一 个 reified.kt 文 件 ， 然后 在 里 面 编写 如 下 代码 : 


inline fun <reified T> startActivity(context: Context) { 
val intent = Intent(context, T::class.java) 
context.startActivity(intent) 


这 里 我 们 定义 了 一 个 startActivity() 哨 数 ， 该 限 数 接收 一 个 Context 参 数 ， 并 同时 使 用 
inLine 和 reified 关 键 字 让 泛 型 T 成 为 了 一 个 被 实 化 的 泛 型 。 接 下 来 就 是 神奇 的 地 方 了 ， 
Intent 接 收 的 第 二 个 参数 本 来 应 该 是 一 个 具体 Activity 的 CLass 类 型 ， 但 由 于 现在 T 已 经 是 一 个 
被 实 化 的 泛 型 了 ， 因 此 这 里 我 们 可 以 直接 传 入 T: :class .java。 最 后 调用 Context 的 
startActivity() 方 法 来 完成 Activity 的 启动 。 


现在 ， 如 果 我 们 想 要 局 动 TestActivity， 只 需要 这 样 写 就 可 以 了 : 


startActivity<TestActivity>(context) 


Kotlin 将 能 够 识别 出 指定 泛 型 的 实际 类 型 ， 并 启动 相应 的 Activity。 怎 么 样 ， 是 不 是 觉得 代码 瞬 
间 精 简 了 好 多 ? 这 就 是 泛 型 实 化 所 带 来 的 神奇 功能 


不 过 ， 现 在 的 startActivity () 函 数 其 实 还 是 有 问题 的 ， 因 为 通常 在 局 用 Activity 的 时 候 还 可 
能 会 使 用 Intent 附 带 一 些 参 数 ， 比 如 下 面 的 写法 : 


val intent = Intent(context, TestActivity::class.java) 
intent.putExtra("paraml", "data") 
intent.putExtra("param2", 123) 
context.startActivity(intent) 
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而 经 过 刚才 的 封装 之 后 ， 我 们 就 无 法 进行 传 参 了 。 


这 个 问题 也 不 难 解决 ， 只 需要 借助 之 前 在 第 6 章 学 习 的 高 阶 范 数 就 可 以 轻松 搞定 。 回 到 
reified.kt 文 件 当 中 ， 这 里 添加 一 个 新 的 startActivity () 国 数 重 载 ， 如 下 所 示 : 


inline fun <reified T> startActivity(context: Context, block: Intent.() -> Unit) { 
val intent = Intent(context, T::class.java) 
intent.block() 
context.startActivity(intent) 


} 


可 以 看 到 ， 这 次 的 startActivity( ) 函 数 中 增加 了 一 个 函数 类 型 参数 ， 并 且 它 的 函数 类 型 是 
定义 在 Intent 类 当中 的 。 在 创建 完 Intent 的 实例 之 后 ， 随 即 调 用 该 水 数 类 型 参数 ， 并 把 Intent 的 
实例 传 入 , 这 样 调用 startActivity() 上 函数 的 时 候 就 可 以 在 Lambda 表 达 式 中 为 Intent 传 递 
参数 了 ， 如 下 所 示 : 


startActivity<TestActivity>(context) { 
putExtra("paraml", "data") 
putExtra("param2", 123) 


} 


不 得 不 说 ,这 种 启动 Activity 的 代码 写 起 来 实在 是 太 舒 服 了 ， 泛 型 实 化 和 高 阶 消 数 使 这 种 语法 结 
构成 为 了 可 能 ， 感谢 Kotlin 提 供 了 如 此 多 优秀 的 语言 特性 。 
好 了 ， 泛 型 实 化 的 具体 应 用 学 到 这 里 就 基本 结束 了 。 虽 然 我 们 一 直 在 使 用 启动 Activity 的 代码 来 


举例 ， 但 是 启动 Service 的 代码 也 是 基本 类 做 的 ， 相 信 对 于 你 来 说 ， 通 过 泛 型 实 化 和 高 阶 函 数 来 
简化 它 的 用 法 已 经 是 小 菜 一 碟 了， 这 个 功能 就 当 作 课 后 习题 让 你 练 练 手 吧 。 


那么 接 下 来 我 们 继续 学 习 泛 型 更 多 的 高 级 特性 。 

10.6.3 ” 泛 型 的 协 变 

泛 型 的 协 变 和 逆 变 功能 不 太 常 用 ， 而 且 我 个 人 认为 有 点 不 容易 理解 。 但 是 Kotlin 的 内 置 API 中 使 
用 了 很 多 协 变 和 逆 变 的 特性 ， 因 此 如 果 想 要 对 这 个 语言 有 更 加 深刻 的 了 解 , 这 部 分 内 容 还 是 有 
必要 学 习 一 下 的 。 

我 在 学 习 协 变 和 首 变 的 时 候 查 阅 了 很 多 资料 ， 这 些 资 料 大 多 十 分 星 涩 难 懂 ， 因 此 也 让 我 对 这 两 
个 知识 点 产生 了 一 些 畏 惧 。 但 是 真正 掌握 之 后 ， 发 现 其 实 也 并 不 是 那么 难 ， 所 以 这 里 我 会 尽量 
使 用 最 简明 的 方式 来 讲解 这 两 个 知识 点 ， 希望 你 可 以 轻松 掌握 。 

在 开始 学 习 协 变 和 逆 变 之 前 ,我们 还 得 先 了 解 一 个 约定 。 一 个 泛 型 类 或 者 泛 型 接口 中 的 方法 ， 
它 的 参数 列表 是 接收 数据 的 地 方 ， 因 此 可 以 称 它 为 in 位 置 ， 而 它 的 返回 值 是 输出 数据 的 地 方 ， 
此 可 以 称 它 为 out 位 置 ， 如 图 10.18 所 示 。 


interface MyClass<T> { 
fun method(param: T): T 
} 


in 位 置 out 位 置 
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图 10.18 in 位 置 和 out 位 置 的 示意 图 
有 了 这 个 约定 前 提 ， 我 们 就 可 以 继续 学 习 3 了。 首先 定义 如 下 3 个 类 : 


open class Person(val name: String, val age: Int) 
class Student(name: String, age: Int) : Person(name, age) 
class Teacher(name: String, age: Int) : Person(name, age) 


这 里 先 定 义 了 一 个 Person 类 ， 类 中 包含 name 和 age 这 两 个 字段 。 然 后 又 定义 了 Student 和 
Teacher 这 两 个 类 ， 让 它们 成 为 Person 类 的 子 类 。 

现在 我 来 间 你 一 个 问题 : 如 果 某 个 方法 接收 一 个 Person 类 型 的 参数 ， 而 我 们 传 入 一 个 Student 
的 实例 ,这样 合 不 合法 呢 ? 很 显然 ， 因 为 Student 是 Person 的 子 类 ， 学 生 也 是 人 是 ， 因 此 这 是 
一 定 合法 的 。 

那么 我 再 来 升级 一 下 这 个 问题 : 如 果 某 个 方法 接收 一 个 List<Person> 类 型 的 参数 ， 而 我 们 传 
入 一 个 List<Student> 的 实例 , 这样 合 不 合法 呢 ? 看 上 去 好 像 也 挺 正确 的 ,但 是 Java 中 是 不 
允许 这 么 做 的 ， 因 为 List<Student> 不 能 成 为 List<Person> 的 子 类 ， 否则 将 可 能 存在 类 型 
转换 的 安全 隐患 。 


为 什么 会 存在 类 型 转换 的 安全 隐患 呢 ? 下 面 我 们 通过 一 个 具体 的 例子 进行 说 明 。 这 里 自 定义 一 
个 SimpLeData 类 ， 代码 如 下 所 示 : 


class SimpleData<T> { 
private var data: T? = null 


fun set(t: T?) { 
data = +t 
} 


fun get(): T? { 
return data 
} 


} 


SimpLeData 是 一 个 泛 型 类 , 它 的 内 部 封装 了 一 个 泛 型 data 字 段 ， 调用 set ( ) 方 法 可 以 给 data 
字段 赋值 ， 调 用 get ( ) 方 法 可 以 获取 data 字 段 的 值 。 


接着 我 们 假设 ， 如果 编程 语言 允许 向 某 个 接收 SimpleData<Person> 参 数 的 方法 传 入 
SimpleData<Student> 的 实例 ， 那么 如 下 代码 就 会 是 合法 的 : 


fun main() { 
val student = Student("Tom", 19) 
val data = SimpleData<Student>() 
data.set (student) 
handleSimpleData(data) // 实际 上 这 行 代码 会 报错 ,这 里 假设 它 能 编译 通过 
val studentData = data.get() 


fun handleSimpleData(data: SimpleData<Person>) { 
val teacher = Teacher("Jack", 35) 
data. set (teacher) 
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发 现 这 段 代 码 有 什么 问题 吗 ? 在 main( ) 方 法 中 ,我 们 创建 了 一 个 Student 的 实例 ， 并 将 它 封 装 
至 JSimpleData<Student> 当 中 ， 然 后 将 SimpleData<Student> 作 为 参数 传递 给 
handleSimpleData() 方 法 。 但 是 handleSimpleData() 方 法 接收 的 是 一 个 
SimpleData<Person> 参 数 (这 里 假设 可 以 编译 通过 ) ， 那 么 在 handleSimpleData() 方 法 
中 ,我 们 就 可 以 创建 一 个 Teacher 的 实例 ， 并 用 它 来 替换 SimpleData<Person> 参 数 中 的 原 
有 数据 。 这 种 操作 肯定 是 合法 的 ， 因 为 Teacher 也 是 Person 的 子 类 ， 所 以 可 以 很 安全 地 将 
Teacher 的 实例 设置 进去 。 


但 是 问题 马上 来 了 ， 回 到 main( ) 方 法 当中 ， 我 们 调用 SimpLeData<Student> 的 get () 方 法 
来 获取 它 内 部 封装 的 Student 数 据 , 可 现在 SimpLeData<Student> 中 实际 包含 的 却 是 一 个 
Teacher 的 实例 ， 那 么 此 时 必然 会 产生 类 型 转换 异常 。 


所 以 ， 为 了 杜绝 这 种 安全 隐患 ，java 是 不 允许 使 用 这 种 方式 来 传递 参数 的 。 换 句 话说， 即使 
Student 是 Person 的 子 类 ，SimpLeData<Student> 并 不 是 SimpLeData<Person> 的 子 


类 。 


不 过 ,回顾 一 下 刚才 的 代码 ， 你 会 发 现 问题 发 生 的 主要 原因 是 我 们 在 handteSimpLeData( ) 方 
法 中 向 SimpLeData<Person> 里 设置 了 一 个 Teacher 的 实例 。 如 果 SimpLeData 在 泛 型 T 上 是 
只 读 的 话 ， 肯 定 就 没有 类 型 转换 的 安全 隐患 了 ， 那 么 这 个 时 候 SimpLeData<Student> 可 不 可 
以 成 为 SimpLeData<Person> 的 子 类 呢 ? 


讲 到 这 里 ， 我 们 终于 要 引出 泛 型 协 变 的 定义 了 。 假 如 定义 了 一 个 MyCLass<T> 的 泛 型 类 ， 其 中 A 
是 B 的 子 类 型 ， 同 时 MyCLass<A> 又 是 MyCLass<B> 的 子 类 型 ， 那 么 我 们 就 可 以 称 MyCLass 在 T 
这 个 泛 型 上 是 协 变 的 。 


但 是 如 何 才 能 让 MyCLass<A> 成 为 MyCLass<B> 的 子 类 型 呢 ? 刚才 已 经 讲 了 ， 如 果 一 个 泛 型 类 
在 其 泛 型 类 型 的 数据 上 是 只 读 的 话 ， 那 么 它 是 没有 类 型 转换 安全 隐患 的 。 而 要 实现 这 一 点 ， 则 
需要 让 MyCLass<T> 类 中 的 所 有 方法 都 不 能 接收 T 类 型 的 参数 。 换 句 话说，T 只 能 出 现在 out 位 置 
上 ， 而 不 能 出 现在 in 位 置 上 。 


现在 修改 SimpLeData 类 的 代码 ， 如 下 所 示 : 


class SimpleData<out T>(val data: T?) { 
fun get(): T? { 


return data 
} 
} 


这 里 我 们 对 SimpLeData 类 进行 了 改造 ， 在 泛 型 T 的 声明 前 面 加 上 了 一 个 out 关 键 字 。 这 就 意味 
着 现在 T 只 能 出 现在 out 位 置 上 ， 而 不 能 出 现在 in 位 置 上 ， 同 时 也 意味 着 SimpLeData 在 泛 型 T 上 
是 协 变 的 。 


由 于 泛 型 T 不 能 出 现在 in 位 置 上 ， 因 此 我 们 也 就 不 能 使 用 set ( ) 方 法 为 data 参 数 赋值 了 ， 所 以 这 
里 改 成 了 使 用 构造 永 数 的 方式 来 赋值 。 你 可 能 会 说 ， 构 造 函 数 中 的 泛 型 T 不 也 是 在 in 位 置 上 的 
吗 ? 没 错 ，, 但 是 由 于 这 里 我 们 使 用 了 val 关 键 字 ， 所 以 构造 浮 数 中 的 泛 型 T 仍 然 是 只 读 的 ， 因 此 
这 样 写 是 合法 且 安全 的 。 另 外 ， 即 使 我 们 使 用 了 var 关 键 字 ， 但 只 要 给 它 加 上 private 修 饰 

符 ， 保 证 这 个 泛 型 T 对 于 外 部 而 言 是 不 可 修改 的 ， 那 么 就 都 是 合法 的 写法 。 
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经 过 了 这 样 的 修改 之 后 ， 下 面 的 代码 就 可 以 完美 编译 通过 且 没 有 任何 安全 隐患 了 : 


fun main() { 
val student = Student("Tom", 19) 
val data = SimpleData<Student>(student) 
handleMyData (data) 
val studentData = data.get() 
} 


fun handleMyData(data: SimpleData<Person>) { 
val personData = data.get() 


由 于 SimpLeData 类 已 经 进行 了 协 变声 明 , 那么 SimpleData<Student> 自 然 就 是 
SimpleData<Person> 的 子 类 了 ， 所 以 这 里 可 以 安全 地 向 handLleMyData( ) 方 法 中 传递 参 
数 。 


然后 在 handLeMyData ( ) 方 法 中 去 获取 SimpLeData 封 装 的 数据 ， 虽 然 这 里 泛 型 声明 的 是 
Person 类 型 ， 实 际 获得 的 会 是 一 个 student 的 实例 ,但 由 于 Person 是 Student 的 父 类 ， 向 上 
转型 是 完全 安全 的 ， 所 以 这 段 代码 没 有 任何 问题 。 


学 到 这 里 ， 关 于 协 变 的 内 容 你 就 掌握 得 差不多 了 “， 不 过 最 后 还 有 个 例子 需要 回顾 一 下 。 前 面 我 
们 提 到 ， 如 果 某 个 方法 接收 一 个 List<Person> 类 型 的 参数 ， 而 传 入 的 却 是 一 个 
List<Student> 的 实例 ， 在 Jlava 中 是 不 允许 这 么 做 的 。 注 意 这 里 我 的 用 语 ， 在 Java 中 是 不 允 
许 这 么 做 的 。 


你 没有 猿 错 ， 在 Kotlin 中 这 么 做 是 合法 的 ， 因为 Kotlin 已 经 默认 给 许多 内 置 的 API 加 上 了 协 变声 
明 ， 其 中 就 包括 了 各 种 集合 的 类 与 接口 。 还 记得 我 们 在 第 2 章 中 学 过 的 吗 ? Kotlin 中 的 List 本 身 
就 是 只 读 的 ， 如 果 你 想 要 给 List 添 加 数据 ， 需 要 使 用 MutableList 才 行 。 既 然 List 是 只 读 的 ， 也 
就 意味 着 它 天 然 就 是 可 以 协 变 的 ， 我 们 来 看 一 下 List 简 化 版 的 源码 : 


public interface List<out E> : Collection<E> { 
override val size: Int 
override fun isEmpty(): Boolean 
override fun contains(element: @UnsafeVariance E): Boolean 
override fun iterator(): Iterator<E> 
public operator fun get(index: Int): E 


} 


List 在 泛 型 E 的 前 面 加 上 了 out 关 键 字 ,说明 List 在 泛 型 E 上 是 协 变 的 。 不 过 这 里 还 有 一 点 需要 说 
明 ,原则 上 在 声明 了 协 变 之 后 ， 泛 型 E 就 只 能 出 现在 out 位 置 上 ，, 可 是 你 会 发 现 ,在 
contains () 方 法 中 , 泛 型 E 仍 然 出 现在 了 in 位 置 上 。 


这 么 写本 身 是 不 合法 的 ， 因 为 在 in 位 置 上 出 现 了 泛 型 E 就 意味 着 会 有 类 型 转换 的 安全 隐患 。 但 是 
contains () 方 法 的 目的 非常 明确 , 它 只 是 为 了 判断 当前 集合 中 是 人 否 包含 参数 中 传 入 的 这 个 元 
素 ， 而 并 不 会 修改 当前 集合 中 的 内 容 ， 因 此 这 种 操作 实质 上 又 是 安全 的 。 那 么 为 了 让 编译 器 能 
够 理解 我 们 的 这 种 操作 是 安全 的 ， 这 里 在 泛 型 E 的 前 面 又 加 上 了 一 个 QUnsafevariance 注 解 ， 
这 样 编译 器 就 会 允许 泛 型 E 出 现在 in 位 置 上 了 。 但 是 如 果 你 滥用 这 个 功能 ， 导致 运 行 时 出 现 了 类 
型 转换 异常 ，Kotlin 对 此 是 不 负责 
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好 了 “， 关 于 协 变 的 内 容 就 学 到 这 里 ， 接 下 来 我 们 开始 学 习 逆 变 的 内 容 。 

10.6.4 泛 型 的 道 变 

理解 了 协 变 之 后 再 来 学 习 逆 变 ， 我 觉得 会 相对 比较 容易 一 些 ， 因 为 它们 之 间 是 有 所 关联 的 。 
不 过 仅 从 定义 上 来 看 ， 逆 变 与 协 变 却 完全 相反 。 那 么 这 里 先 引 出 定义 吧 ， 假 如 定义 了 一 个 


MyCLass<T> 的 泛 型 类 ， 其 中 A 是 B 的 子 类 型 ， 同 时 MyCLass<B> 又 是 MyCLass<A> 的 子 类 型 ， 
那么 我 们 就 可 以 称 MyCLass 在 T 这 个 泛 型 上 是 逆 变 的 。 协 变 和 逆 变 的 区 别 如 图 10.19 所 示 。 


B MyClass<B> MyClass<A> 
协 变 逆 变 
A MyClass<A> MyClass<B> 


图 10.19 ” 协 变 与 逆 变 的 区 别 


从 直观 的 角度 上 来 思考 ， 逆 变 的 规则 好 像 捏 奇怪 的 ， 原 本 A 是 B 的 子 类 型 ， 怎么 MyCLass<B> 能 
反 过 来 成 为 MyCLass<A> 的 子 类 型 了 呢 ? 别 担心 ， 下 面 我 们 通过 一 个 具体 的 例子 来 学 习 一 下 ， 
你 就 明白 了 。 


这 里 先 定义 一 个 Transformer 接 口 ， 用 于 执行 一 些 转换 操作 ,代码 如 下 所 示 : 


interface Transformer<T> { 
fun transform(t: T): String 
} 


可 以 看 到 ,Transformer 接 口中 声明 了 一 个 transform() 方 法 , 它 接收 一 个 T 类 型 的 参数 ， 并 
且 返 回 一 个 String 类 型 的 数据 ,这 意味 着 参数 T 在 经 过 transform( ) 方 法 的 转换 之 后 将 会 变 成 
一 个 字符 串 。 至 于 具体 的 转换 逻辑 是 什么 样 的 ， 则 由 子 类 去 实现 , Transformer 接口 对 此 并 不 
关心 。 


那么 现在 我 们 就 尝试 对 Transformer 接 口 进行 实现 ， 代 码 如 下 所 示 : 


fun main() { 
val trans = object : Transformer<Person> { 
override fun transform(t: Person): String { 
return "${t.name} ${t.age}" 


} 
handleTransformer(trans) // 这 行 代码 会 报错 
} 


fun handleTransformer(trans: Transformer<Student>) { 
val student = Student("Tom", 19) 
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val result = trans.transform(student) 


} 


首先 我 们 在 main ( ) 方 法 中 编写 了 一 个 Transformer<Person> 的 匿名 类 实现 ， 并 通过 
transform() 方 法 将 传 入 的 Person 对 象 转换 成 了 一 个 “姓名 + 年 龄 "拼接 的 字符 串 。 而 
handtLeTransformer( ) 方 法 接收 的 是 一 个 Transformer<Student> 类 型 的 参数 ， 这 里 在 
handtLeTransformer() 方 法 中 创建 了 一 个 student 对 象 ， 并 调用 参数 的 transform( ) 方 法 
将 Student 对 象 转 换 成 一 个 字符 串 。 


这 段 代码 从 安全 的 角度 来 分 析 是 没有 任何 问题 的 ， 因 为 Student 是 Person 的 子 类 ,使 用 
Transformer<Person> 的 匿名 类 实现 将 Student 对 象 转换 成 一 个 字符 串 也 是 绝对 安全 的 ， 并 
不 存在 类 型 转换 的 安全 隐患 。 但 是 实际 上 ， 在 调用 handleTransformer() 方 法 的 时 候 却 会 提 
示 语 法 错误 ， 原 因 也 很 简单 ，Transformer<Person> 并 不 是 Transformer<Student> 的 子 
类 型 。 


那么 这 个 时 候 逆 变 就 可 以 派 上 用 场 了 ， 它 就 是 专门 用 于 处 理 这 种 情况 的 。 修 改 Transformer 接 
口中 的 代码 ， 如 下 所 示 : 


interface Transformer<in T> { 
fun transform(t: T): String 
4 


这 里 我 们 在 泛 型 T 的 声明 前 面 加 上 了 一 个 in 关键 字 。 这 就 意味 着 现在 T 只 能 出 现在 in 位 置 上 ， 而 
不 能 出 现在 out 位 置 上 ,同时 也 意味 着 Transformer 在 泛 型 T 上 是 逆 变 的 。 

没 错 ， 只 要 做 了 这 样 一 点 修改 ,刚才 的 代码 就 可 以 编译 通过 且 正 常 运行 了 ,因为 此 时 
Transformer<Person> 已 经 成 为 了 Transformer<Student> 的 子 类 型 。 

逆 变 的 用 法 大 概 就 是 这 样 了 ,如果 你 还 想 再 深入 思考 一 下 的 话 ， 可 以 想 一 想 为 什么 逆 变 的 时 候 
泛 型 T 不 能 出 现在 out 位 置 上 ? 为 了 解释 这 个 问题 ， 我们 先 假 设 逆 变 是 允许 让 泛 型 T 出 现在 out 位 
置 上 的 ， 然 后 看 一 看 可 能 会 产生 什么 样 的 安全 隐患 。 


修改 Transformer 中 的 代码 ， 如 下 所 示 : 


interface Transformer<in T> { 
fun transform(name: String, age: Int): @UnsafeVariance T 
} 


可 以 看 到 ,我们 将 transform( ) 方 法 改 成 了 接收 name 和 age 这 两 个 参数 ， 并 把 返回 值 类 型 改 成 
了 泛 型 T。 由 于 逆 变 是 不 允许 泛 型 T 出 现在 out 位 置 上 的 ,这 里 为 了 能 让 编译 器 正常 编译 通过 ， 所 
以 加 上 了 @UnsafeVariance 注 和 解 , 这 和 List 源 码 中 使 用 的 技巧 是 一 样 的 。 


那么 ， 这 个 时 候 可 能 会 产生 什么 样 的 安全 隐患 呢 ? 我 们 来 看 一 下 如 下 代码 就 知道 了 : 


fun main() { 
val trans = object : Transformer<Person> { 
override fun transform(name: String, age: Int): Person { 
return Teacher(name, age) 
} 
} 
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handLeTransformer(trans ) 


fun handleTransformer(trans: Transformer<Student>) { 
val result = trans.transform("Tom", 19) 


} 


上 述 代码 就 是 一 个 典型 的 违反 逆 变 规则 而 造成 类 型 转换 异常 的 例子 。 在 
Transformer<Person> 的 匿名 类 实现 中 ， 我们 使 用 transform() 方 法 中 传 入 的 Name 和 age 
参数 构建 了 一 个 Teacher 对 象 ， 并 把 这 个 对 象 直接 返回 。 由 于 transform( ) 方 法 的 返回 值 要 求 
是 一 个 Person 对 象 ， 而 Teacher 是 Person 的 子 类 ,因此 这 种 写法 肯定 是 合法 的 。 


但 在 handleTransformer() 方 法 当中 ，, 我们 调用 了 Transformer<Student> 的 
transform() 方 法 , 并 传 入 了 name 和 age 这 两 个 参数 ， 期 望 得 到 的 是 一 个 Student 对 象 的 返 
回 , 然而 实际 上 transform( ) 方 法 返回 的 却 是 一 个 Teacher 对 象 ， 因 此 这 里 必然 会 造成 类 型 转 
换 异 常 。 


由 于 这 段 代 码 是 可 以 编译 通过 的 ， 那 么 我 们 可 以 运行 一 下 ， 打 印 出 的 异常 信息 如 图 10.20 所 示 。 


Run: 二 TransformkKt 
BE "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Exception in thread "main" java.lang.ClassCastException: Teacher cannot be cast to Student 
at TransformKt.handleTransformer(transform, kt: 30) 
at TransformKt.main(transform,. kt:26) 
at TransformKt.main(transform.kt) 


ly <€ > 


mn Process finished with exit code 1 


图 10.20 ” 首 变 使 用 不 当 造 成 的 类 型 转换 异常 
可 以 看 到 ,提示 我 们 Teacher 类 型 是 无 法 转换 成 Student 类 型 的 。 


也 就 是 说 ，Kotlin 在 提供 协 变 和 逆 变 功能 时 ， 就 已 经 把 各 种 潜在 的 类 型 转换 安全 隐患 全 部 考虑 进 
去 了 。 只 要 我 们 严格 按照 其 语法 规则 ， 让 泛 型 在 协 变 时 只 出 现在 out 位 置 上 ， 逆 变 时 只 出 现在 in 
位 置 上 ， 就 不 会 存在 类 型 转换 异常 的 情况 。 虽 然 QUnsafeVariance 注 解 可 以 打破 这 一 语法 规 
则 , 但 同时 也 会 带 来 额外 的 风险 ， 所 以 你 在 使 用 @UnsafeVariance 注 解 时 ， 必须 很 清楚 自己 
在 干什么 才 行 。 


最 后 我 们 再 来 介绍 一 下 逆 变 功能 在 Kotlin 内 置 APl 中 的 应 用 ,比较 典型 的 例子 就 是 ComparabtLe 
的 使 用 。Comparable 是 一 个 用 于 比较 两 个 对 象 大 小 的 接口 ， 其 源码 定义 如 下 : 


interface Comparable<in T> { 
operator fun compareTo(other: T): Int 
} 


可 以 看 到 ，Comparable 在 T 这 个 泛 型 上 就 是 逆 变 的 ，compareTo() 方 法 则 用 于 实现 具体 的 比 
较 逻 辑 。 那 么 这 里 为 什么 要 让 Compa rabtLe 接 口 是 逆 变 的 呢 ? 想象 如 下 场景 ， 如 果 我 们 使 用 
ComparabLe<Person> 实 现 了 让 两 个 Person 对 象 比 较 大 小 的 逻辑 ， 那 么 用 这 段 逻辑 去 比较 两 
个 Student 对 象 的 大 小 也 一 定 是 成 立 的 ， 因 此 让 ComparabLe<Person> 成 为 
ComparabLe<Student> 的 子 类 合情合理 ， 这 也 是 逆 变 非常 典型 的 应 用 。 


好 了 “， 关 于 协 变 和 逆 变 的 内 容 就 到 此 为 止 ， 下 面 我 们 就 来 回顾 一 下 本 章 所 学 的 内 容 吧 。 
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10.7 小 结 与 反 评 


在 本 章 中 ， 我 们 学 习 了 很 多 与 Service 相 关 的 重要 知识 点 ,包括 Android 多 线程 编程 、Service 
的 基本 用 法 、Service 的 生命 周期 、 前 台 Service 和 IntentService 等 。 这 些 内 容 已 经 覆盖 了 大 
部 分 你 在 日 常 开发 中 可 能 用 到 的 Service 技 术 , 相信 以 后 不 管 遇 到 什么 样 的 Service 难 题 ， 你 都 
能 从 容 解决 。 


在 本 章 的 Kotlin 课 堂 中 ,我 们 学 习 了 泛 型 的 高 级 特性 ,对 泛 型 的 理解 程度 一 下 子 上 升 了 好 几 个 档 
次 。 泛 型 实 化 在 Kotlin 中 是 特别 有 用 的 一 个 特性 ， 通 过 具体 的 示例 演示 ， 相信 你 已 经 体会 到 了 ， 
借助 此 特性 可 以 不 断 地 优化 自己 的 代码 。 至 于 协 变 和 逆 变 ， 确 实 有 一 定 的 难度 ， 不 过 我 已 经 尽 
可 能 用 最 简明 的 方式 来 讲解 这 两 个 知识 点 ， 希望 你 将 它们 都 理解 到 位 了 。 


另外 ， 本 章 同样 是 具有 里 程 碑 式 的 纪念 意义 的 ， 因 为 我 们 已 经 将 Android 四 大 组 件 全 部 学 完了 。 
对 于 你 来 说 ， 现 在 已 经 脱离 了 Android 初 级 开发 者 的 身份 ， 并 且 应 该 具备 独立 完成 很 多 功能 的 能 
力 了 。 


那么 后 面 我 们 应 该 再 接 再 厉 ， 争取 进 一 步 提升 自身 的 能 力 ， 所 以 现在 还 不 是 放松 的 时 候 。 目 前 


我 们 所 学 的 所 有 东西 仅仅 是 在 本 地 进行 的 ， 而 实际 上 市 场 上 的 绝 大 多 数 应 用 还 会 涉及 网 络 交 互 
的 部 分 ， 所 以 下 一 章 我 们 就 来 学 习 一 下 Android 网 络 编程 方面 的 内 容 。 
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第 11 章 ”看 看 精彩 的 世界 ， 使 用 网 络 技术 


如 果 你 在 玩 手 机 的 时 候 不 能 上 网 ， 那 你 一 定 会 感到 特别 地 枯燥 乏 味 。 没 错 ， 现 在 早已 不 是 玩 单 
机 的 时 代 了 ， 无 论 是 PC、 手 机 、 平 板 ， 还 是 电视 ， 都 具备 上 网 的 功能 ，21 世 纪 的 确 是 互联 网 的 
时 代 。 


当然 ，Android 手 机 肯定 也 是 可 以 上 网 的 。 作 为 开发 者 ， 我 们 就 需要 考虑 如 何 利用 网 络 编写 出 更 
加 出 色 的 应 用 程序 ， 像 QQ、 微 博 、 微 信 等 常见 的 应 用 都 会 大 量 使 用 网 络 技术 。 本 章 主要 讲述 如 
何在 手机 端 使 用 HTTP 和 服务 器 进行 网 络 交 互 ， 并 对 服务 器 返回 的 数据 进行 解析 ， 这 也 是 
Android 中 最 常 使 用 到 的 网 络 技 术 ， 下 面 就 让 我 们 一 起 来 学 习 一 下 吧 。 
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11.1 WebView 的 用 法 


有 时 候 我 们 可 能 会 碰 到 一 些 比较 特殊 的 需求 ,比如 说 在 应 用 程序 里 展示 一 些 网 页 。 相 信 每 个 人 
都 知道 ， 加 载 和 显示 网 页 通常 是 浏览 需 的 任务 ， 但 是 需求 里 又 明确 指出 ， 不 允许 打开 系统 浏览 
器 ,我们 当然 不 可 能 自己 去 编写 一 个 浏览 器 出 来 ， 这 时 应 该 怎么 办 呢 ? 


不 用 担心 ， Android 早 就 考虑 到 了 这 种 需求 ， 并 提供 了 一 个 WebView 控 件 ， 借助 它 我 们 就 可 以 
在 自己 的 应 用 程序 里 肉 入 一 个 浏览 器 ， 从 而 非常 轻松 地 展示 各 种 各 样 的 网 页 。 


WebView 的 用 法 也 相当 简单 ， 下 面 我 们 就 通过 一 个 例子 来 学 习 一 下 吧 。 新 建 一 个 
WebViewTest 项 目 ， 然 后 修改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:Layout width="match parent" 
android:layout height="match parent" > 


<WebView 
android:id= "@+id/webView" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</LinearLayout> 


可 以 看 到 ,我们 在 布局 文件 中 使 用 到 了 一 个 新 的 控件 : WebView。 这 个 控件 就 是 用 来 显示 网 页 
的 ， 这 里 的 写法 很 简单 ， 给 它 设 置 了 一 个 id， 并 让 它 充 满 整个 屏幕 。 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
webView.settings.javaScriptEnabled=true 
webView.webViewClient = WebViewClient() 
webView.loadUrtl("https://www.baidu.com") 


} 


MainActivity 中 的 代码 也 很 短 ， 通过 WebView 的 getSettings() 方 法 可 以 设置 一 些 浏 览 器 的 
属性 ， 这 里 我 们 并 没有 设置 过 多 的 属性 ， 只 是 调用 了 setJavaScriptEnabled() 方 法 ,让 
WebView 支 持 javaScript 脚 本 。 


接 下 来 是 比较 重要 的 一 个 部 分 ， 我 们 调用 了 WebView 的 setWebViewCLient () 方 法 ， 并 传 入 
了 一 个 WebViewcClient 的 实例 。 这 段 代 码 的 作用 是 ， 当 需要 从 一 个 网 页 跳 转 到 另 一 个 网 页 时 ， 
我 们 希望 目标 网 页 仍然 在 当前 WebView 中 显示 ， 而 不 是 打开 系统 浏览 器 


最 后 一 步 就 非常 简单 了 ，, 调用 WebView 的 LoadUrl() 方 法 ,并 将 网 址 传 入 ， 即 可 展示 相应 网 
页 的 内 容 ， 这 里 就 让 我 们 看 一 看 百度 的 首页 长 什么 样 吧 。 
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另外 还 需要 注意 ， 由 于 本 程序 使 用 到 了 网 络 功能 ， 而 访问 网 络 是 需要 声明 权限 的 ， 因 此 我 们 还 
得 修改 AndroidManifest.xmlI 文 件 , 并 加 入 权限 声明 ,如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.webviewtest"> 


<uses-permission android:name="android,.permission.INTERNET” /> 


</manifest> 


在 开始 运行 之 前 ， 确 保 你 的 手机 或 模拟 器 是 联网 的 。 然 后 就 可 以 运行 一 下 程序 了 ， 效 果 如 图 
11.1 所 示 。 


10:25 


WebViewTest 


又 是 一 年 开学 季 ， 听 青年 “引路 人 "习近平 这 样 说 


全 午 顶 / 


阿里 投资 80 亿 ， 华 为 投资 300 亿 ， 这 座 二 线 城市 


如 果 将 地 球 比 作 直 径 为 1 厘米 的 玻璃 球 ， 宇 宙 其 
他 天 体会 有 多 大 ? 


图 11.1 使 用 WebView 加 载 网 页 
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可 以 看 到 ，WebViewTest 这 个 程序 现在 已 经 具备 了 一 个 简易 浏览 器 的 功能 ， 不仅 成 功 将 百度 的 
首页 展示 了 出 来 ， 还 可 以 通过 点 击 链接 浏览 更 多 的 网 页 。 

当然 ，WebView 还 有 很 多 更 加 高 级 的 使 用 技巧 ， 我们 就 不 再 继续 探讨 了 ， 因 为 那 不 是 本 章 的 重 
点 。 这 里 先 介绍 了 一 下 WebView 的 用 法 ， 只 是 希望 你 能 对 HTTP 有 一 个 最 基本 的 认识 ， 接 下 来 
我 们 就 要 利用 这 个 协议 做 一 些 真 正 的 网 络 开发 工作 了 。 
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11.2 使 用 HTTP 访 问 网 络 


如 果 说 真 的 要 去 深入 分 析 HTTP， 可 能 需要 花费 整整 一 本 书 的 篇 幅 。 这 里 我 当然 不 会 这 么 干 ， 
为 毕竟 你 是 跟着 我 学 习 Android 开 发 的 ， 而 不 是 网 站 开发 。 对 于 HTTP ,你 只 需要 稍微 了 解 一 些 
就 足够 了 ， 它 的 工作 原理 特别 简单 ， 就 是 客户 端 向 服务 器 发 出 一 条 HTTP 请 求 ， 服 务 器 收 到 请求 
之 后 会 返回 一 些 数据 给 客户 端 ， 然 后 客户 端 再 对 这 些 数据 进行 解析 和 处 理 就 可 以 了 。 是 不 是 非 

常 简单 ?一 个 浏览 更 的 基本 工作 原理 也 就 是 如 此 了 。 比 如 说 上 一 节 中 使 用 到 的 WebView 控 件 ， 

其 实 就 是 我 们 向 百度 的 服务 器 发 起 了 一 条 HTTP 请 求 ， 接 着 服务 器 分 析出 我 们 想 要 访问 的 是 百度 
的 首页 , 于 是 把 该 网 页 的 HTML 代 码 进 行 返 回 ， 然后 WebView 再 调用 手机 浏览 器 的 内 核对 返回 
的 HTML 代 码 进 行 解析 ， 最终 将 页 面 展示 出 来 。 


简单 来 说 ,WebView 已 经 在 后 台 帮 我 们 处 理 好 了 发 送 HTTP 请 求 、 接 收服 务 北 响应 、 解 析 返 回 
数据 ， 以 及 最 终 的 页 面 展示 这 几 步 工作 ， 只 不 过 它 封 装 得 实在 是 太 好 了 ， 反 而 使 得 我 们 不 能 那 
么 直观 地 看 出 HTTP 到 底 是 如 何 工作 的 。 因 此 ， 接 下 来 就 让 我 们 通过 手动 发 送 HTTP 请 求 的 方式 
更 加 深入 地 理解 这 个 过 程 。 


11.2.1 使 用 HttpURLConnection 


在 过 去 ，Android 上 发 送 HTTP 请 求 一 般 有 两 种 方式 : HttpURLConnection 和 HttpClient。 不 

过 由 于 HttpClient 存 在 API 数 量 过 多 、 扩 展 困难 等 缺点 , Android 团 队 越 来 越 不 建议 我 们 使 用 这 
种 方式 。 终 于 在 Android 6.0 系 统 中 ，HttpClient 的 功能 被 完全 移 除 了 ， 标 志 着 此 功能 被 正式 弃 
用 ， 因 此 本 小 节 我 们 就 学 习 一 下 现在 官方 建议 使 用 的 HttpURLConnection 的 用 法 。 


首先 需要 获取 HttpURLConnection 的 实例 ， 一 般 只 需 创 建 一 个 URL 对 象 ， 并 传 入 目标 的 网 络 地 
址 ,然后 调用 一 下 openConnection() 方 法 即 可 ,如 下 所 示 : 


val url = URL("https://www.baidu.com") 
val connection = url.openConnection() as HttpURLConnection 


在 得 2 了 HttpURLConnection 的 实例 之 后 ,我 们 可 以 设置 一 下 HTTP 请 求 所 使 用 的 方法 。 常 用 
的 方法 主要 有 两 个 : GET 和 P0ST。GET 表 示 希 望 从 服务 器 那里 获取 数据 ， 而 P0ST 则 表示 希望 提 
交 数 据 给 服务 器 。 写 法 如 下 : 


connection.requestMethod = "GET" 


接 下 来 就 可 以 进行 一 些 自由 的 定制 7， 比如 设置 连接 超时 、 读 取 超 时 的 富 秒 数 ， 以 及 服务 器 希 
望 得 到 的 一 些 消息 头等 。 这 部 分 内 容 根据 自己 的 实际 情况 进行 编写， 示例 写法 如 下 : 


connection.connectTimeout = 8000 

connection.readTimeout = 8000 

之 后 再 调用 getInputStream() 方 法 就 可以 获取 到 服务 器 返回 的 输入 流 了 ， 猎 下 的 任务 就 是 对 
输入 流 进行 读 取 : 


val input = connection.inputStream 
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最 后 可 以 调用 disconnect ( ) 方 法 将 这 个 HTTP 连 接 关 闭 : 


connection.disconnect() 


下 面 就 让 我 们 通过 一 个 具体 的 例子 来 真正 体验 一 下 HttpURLConnection 的 用 法 。 新 建 一 个 
NetworkTest 项 目 ， 首 先 修改 activity_ main.xml 中 的 代码 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="match parent" > 


<Button 
android:id="@+id/sendRequestBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Send Request" /> 


<ScrollView 
android:layout width="match parent" 
android:layout height="match parent" > 


<TextView 
android:id="@+id/responseText" 
android:layout width="match parent" 
android:layout height="wrap content" /> 


</ScrollView> 


</LinearLayout> 


注意 ， 这 里 我 们 使 用 了 一 个 新 的 控件 : ScrollView。 它 是 用 来 做 什么 的 呢 ? 由 于 手机 屏幕 的 空 
间 一 般 比较 小 , 有些 时 候 过 多 的 内 容 一 屏 是 显示 不 下 的 ， 借 助 ScrollView 控 件 ， 我 们 就 可 以 以 
滚动 的 形式 查看 屏幕 外 的 内 容 。 另 外 ， 布 局 中 还 放置 了 一 个 Button 和 一 个 TextView，Button 
用 于 发 送 HTTP 请 求 ，TextView 用 于 将 服务 絮 返 回 的 数据 显示 出 来 。 


接着 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
sendRequestBtn.setOnClickListener { 
sendRequestwWithHttpURLConnection() 
} 
} 


private fun sendRequestWithHttpURLConnection() { 
// 开启 线程 发 起 网 络 请 求 
thread { 
var connection: HttpURLConnection? = null 
try { 
val response = StringBuilder() 
val url = URL("https://www.baidu.com") 
connection = url.openConnection() as HttpURLConnection 
connection.connectTimeout = 8000 
connection. readTimeout = 8000 
val input = connection.inputStream 
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// 下 面 对 获 取 到 的 输入 流 进 行 读 取 
val _ reader = BufferedReader(InputStreamReader(input)) 
reader.use { 
reader.forEachLine { 
response.append (it) 
} 


} 
showResponse(response.toString()) 
} catch (e: Exception) { 
e.printStackTrace() 
} finally { 
connection?.disconnect() 
} 


} 
private fun showResponse(response: String) { 
runOnUiThread { 


// 在 这 里 进行 UI 操作 ,将 结果 显示 到 界面 上 
responseText.text = response 


} 


可 以 看 到 ,我们 在 “Send Request” 按 钮 的 点 击 事件 里 调用 了 
sendRequestWithHttpURLConnection() 方 法 ， 在 这 个 方法 中 先是 开启 了 一 个 子 线程 ， 然 
后 在 子 线程 里 使 用 HttpURLConnection 发 出 一 条 HTTP 请 求 ， 请求 的 目标 地 址 就 是 百度 的 首 
页 。 接 着 利用 BufferedReader 对 服务 器 返回 的 流 进行 读 取 ， 并 将 结果 传 入 showResponse() 
方法 中 。 而 在 showResponse( ) 方 法 里 ， 则 是 调用 了 一 个 run0nUiThread ( ) 方 法 ,然后 在 这 
个 方法 的 Lambda 表 达 式 中 进行 操作 ， 将 返回 的 数据 显示 到 界面 上 。 


那么 这 里 为 什么 要 用 这 个 run0nUiThread ( ) 方 法 呢 ? 别 忘 了 ，Android 是 不 允许 在 子 线程 中 进 
行 Ul 操 作 的 。 我 们 在 10.2.3 人 小节 中 学 习 了 异步 消息 处 理 机 制 的 工作 原理 ,而 

run0nUiThread ( ) 方 法 其 实 就 是 对 异步 消息 处 理 机 制 进行 了 一 层 封装 ， 它 背后 的 工作 原理 和 
10.2.3 小 节 中 所 介绍 的 内 容 是 一 模 一 样 的 。 借 助 这 个 方法 ， 我们 就 可 以 将 服务 器 返回 的 数据 更 
新 到 界面 上 了 。 


完整 的 流程 就 是 这 样 。 不 过 在 开始 运行 之 前 ， 仍 然 别 忘 了 要 声明 一 下 网 络 权 限 。 修 改 
AndroidManifest.xml 中 的 代码 , 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


好 了 ， 现 在 运行 一 下 程序 ， 并 点 击 “Send Request” 按 钮 ， 结果 如 图 11.2 所 示 。 
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NetworkTest 


SEND REQUEST 


<IDOCTYPE html><html><!-STATUS OK~><head><meta 
charset="utf-8"><title> 百 度 一 下 ,你 就 知道 </title><meta 
http-equiv= Cache-control ” content= no-cache ><meta 
name="viewport" content="width=device-width,minimum-sc 
ale=1.0,maximum-scale=1.0,user-scalable=no"><script>var 
dateTime = Date.now();document.cookie="bd_af=1; expires="+1 
*24*3600*1000+"; path=/;"+"domain'+".baidy.com'";function 
addUrlPara(name, value) {var currentUr| = 
window,location.href.split('#')[0]if (/\?/g.test(currentUrl)) {var re 
= new RegExp(name + "=[-\\w]{1,25}', 'g');if (re.test(currentUr|)) 
{currentUr| = currentUrl.replace(re, name + "=" + value);} else 
{currentUr| += "&" + name+ "=" + value;}} else {currentUr| += 
"?"+name + "= + value;}if (window.location.href.split('#') 

[1]) {window.location.href = currentUrl + '#° + 
window.location.href.split(#'")[1],} else {window.location.href 

= currentUrl.}}try {if (localStorage.getitem(bd_rd)) 
{localStorage.setltem(bd_rd',dateTime);addUrlPara( bd_af',1'),} 
else if (dateTime - localStorage.getltem(bd_rd) > 1*24*3600* 
1000) {localStorage.setltem(bd_rd'dateTime);addUrlPara('bd_af', 
1");}} catch(err) {}</script><style type='text/css >body 

{margin: 0;text-align: center,font-size: 14px;font-family: Arial 
Helvetica, LiHei Pro Medium;color: #262626;}form {position 
relative;margin: 12px 15px 91px;height: 41px;}img {border 
0;}.word-wrap {margin-right: 85px;}#word {background-color 
#FFF;border: 1px solid #6E6E6E;color: #000;font-size 
18px;height: 27px;padding: 6px;width: 100% ;-webkit-appearance 
none;-webkit-border-radius: 0;border-radius: 0;}.bn 
{background-color: #FS5FS5FS5;border: 1px solid #787878;,font-size 
16px;font-weight; 700;height: 41px;letter-spacing: -1px;line-height: 
41pxpadding: 0;position: absolute;right: 0;text-align: centertop 
0;width: 72px;-webkit-appearance: none;-webkit-box-sizing 
border-box;box-sizing: border-box;-webkit-border-radius 
0;border-radius: 0;}.lg {margin-top: 30px;}a {text-decoration 


图 11.2 服务 器 响应 的 数据 


是 不 是 看 得 头晕 眼花 ? 没 错 ， 服务 器 返回 给 我 们 的 就 是 这 种 HTML 代 码 ， 只 是 通常 情况 下 ; 
会 将 这 些 代 码 解析 成 漂亮 的 网 页 后 再 展示 出 来 。 


那么 如 果 想 要 提交 数据 给 服务 器 应 该 怎么 办 呢 ? 其 实 也 不 复杂 ,只 需要 将 HTTP 请 求 的 方法 改 成 
P0ST， 并 在 获取 输入 流 之 前 把 要 提交 的 数据 与 出 即 可 。 注 意 ,每 条 数据 都 要 以 键 值 对 的 形式 存 
在 ,数据 与 数据 之 间 用 “&" 符 号 隐 开 。 比 如 说 我 们 想 要 向 服务 莫 提 交 用 户 名 和 密码 ,就 可 以 这 样 
与 : 


Ss 


connection.requestMethod = "POST" 
val output = DataOutputStream(connection.outputStream) 
output .writeBytes("username=admin&password=123456") 


好 了 ， 相 信 你 已 经 将 HttpURLConnection 的 用 法 很 好 地 掌握 了 。 
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11.2.2 使 用 OkHttp 


当然 我 们 并 不 是 只 能 使 用 HttpURLConnection , 完全 没有 任何 其 他 选择 ， 事实 上 在 开源 盛行 的 
今天 ,有 许多 出 色 的 网 络 通信 库 都 可 以 替代 原生 的 HttpURLConnection ,而 其 中 OkHttp 无 疑 
是 做 得 最 出 色 的 一 个 。 


OKkHttp 是 由 易 易 大 名 的 Square 公司 开发 的 ， 这 个 公司 在 开源 事业 上 贡献 良 多 ,除了 OKkHttp 之 
外 ， 还 开发 了 Retrofit、Picasso 等 知名 的 开源 项 目 。OkHttp 不 仅 在 接口 封装 上 做 得 简单 易 用 ， 
就 连 在 底层 实现 上 也 是 自 成 一 派 ， 比 起 原生 的 HttpURLConnection， 可 以 说 是 有 过 之 而 无 不 
及 ， 现 在 已 经 成 了 广大 Android 开 发 者 首选 的 网 络 通信 库 。 那 么 本 小 节 我 们 就 来 学 习 一 下 
OkHttp 的 用 法 。OkHttp 的 项 目 主页 地 址 是 : https://github.com/square/okhttp。 


在 使 用 OkHttp 之 前 ,我们 需要 先 在 项 目 中 添加 OkHttp 库 的 依赖 。 编 辑 app/build.gradle 文 
件 ,在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 


implementation 'com.squareup.okhttp3:okhttp:4.1.0'" 


} 


添加 上 述 依赖 会 自动 下 载 两 个 库 : 一 个 是 OkHttp 库 , 一 个 是 Okio 库 , 后 者 是 前 者 的 通信 基础 。 
其 中 4.1.0 是 我 写本 书 时 OkHttp 的 最 新 版 本 ， 你 可 以 访问 OkHttp 的 项 目 主页 ,查看 当前 最 新 的 


版 本 是 多 少 。 


下 面 我 们 来 看 一 下 OkHttp 的 具体 用 法 ,首先 需要 创建 一 个 0kHttpClient 的 实例 ,如 下 所 示 : 


val client = OkHttpClient() 


接 下 来 如 果 想 要 发 起 一 条 HTTP 请 求 ， 就 需要 创建 一 个 Request 对 象 : 


val request = Request.Builder().build!() 


当然 ， 上 述 代 码 只 是 创建 了 一 个 空 的 Request 对 象 ， 并 没有 什么 实际 作用 ， 我们 可 以 在 最 终 的 
build() 方 法 之 前 连 缀 很 多 其 他 方法 来 丰富 这 个 Request 对 象 。 比 如 可 以 通过 url ( ) 方 法 来 设 
置 目标 的 网 络 地 址 ， 如 下 所 示 : 


val request = Request.Builder() 
.url("https://www.baidu.com") 
.build() 


之 后 调用 OkHttpClient 的 newCall ( ) 方 法 来 创建 一 个 CaLL 对 象 ， 并 调用 它 的 execute ( ) 方 法 
来 发 送 请 求 并 获取 服务 器 返回 的 数据 ， 写 法 如 下 : 


val response = client,.newCall(request).execute() 


Response 对 象 就 是 服务 器 返回 的 数据 了 ， 我们 可 以 使 用 如 下 写法 来 得 到 返回 的 具体 内 容 : 


val responseData = response.body?.string() 
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如 果 是 发 起 一 条 POST 请求， 会 比 GET 请 求 稍微 复杂 一 点 ， 我 们 需要 先 构 建 一 个 Redquest Body 
对 象 来 存放 待 提交 的 参数 ， 如 下 所 示 : 


val _ requestBody = FormBody.BuiLder() 


.add("username"， "admin") 
.add("password", "123456") 
.build() 


然后 在 Request.Builder 中 调用 一 下 post ( ) 方 法 ,并 将 RequestBody 对 象 传 入 : 


val _ request = Request.Builder() 
.url("https://www.baidu.com") 
.post (requestBody) 
.build() 


接 下 来 的 操作 就 和 GET 请 求 一 样 了 ， 调 用 execute ( ) 方 法 来 发 送 请 求 并 获取 服务 器 返回 的 数据 
oJ。 


好 了 ，OkHttp 的 基本 用 法 就 先 学 到 这 里 ， 在 本 章 的 稍 后 部 分 我 们 还 会 学 习 OkHttp 结 合 Retrofit 
的 使 用 方法 ， 到 时 候 再 进一步 学 习 。 那 么 现在 我 们 先 把 NetworkTest 这 个 项 目 改 用 OkHttp 的 方 
式 再 实现 一 遍 吧 。 


由 于 布局 部 分 完全 不 用 改动 ， 所 以 直接 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
sendRequestBtn.setOnClickListener { 
sendRequestwithOkHttp() 
} 
} 
private fun sendRequestWithOkHttp() { 
thread { 
try { 
val client = OkHttpClient() 
val request = Request.Builder() 
.url("https://www.baidu.com") 
.build() 
val response = client.newCall(request).execute() 
val responseData = response.body?.string() 
if (responseData != null) { 
showResponse(responseData) 
} 
} catch (e: Exception) { 
e.printStackTrace() 
} 
} 
} 
} 


这 里 我 们 并 没有 做 太 多 的 改动 ， 只 是 添加 了 一 个 sendRequestwith0OkHttp() 方 法 , 并 
在 “Send Request” 按 钮 的 点 击 事件 里 调用 这 个 方法 。 在 这 个 方法 中 同样 还 是 先 开启 了 一 个 子 线 
程 ， 然 后 在 子 线程 里 使 用 OkHttp 发 出 一 条 HTTP 请 求 ， 请 求 的 目标 地 址 还 是 百度 的 首页 ， 
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OkHttp 的 用 法 也 正如 前 面 所 介绍 的 一 样 。 最 后 仍然 调用 了 showResponse() 方 法 , 将 服务 器 
返回 的 数据 显示 到 界面 上 。 


仅仅 是 改 了 这 么 多 代码 , 现在 我 们 就 可 以 重新 运行 一 下 程序 了 。 点 击 “Send Request” 按 钮 后 ， 


你 会 看 到 和 上 一 小 节 中 同样 的 运行 结果 。 由 此 证 明 ， 使 用 OkHttp 来 发 送 HTTP 请 求 的 功能 也 已 
经 成 功 实现 了 。 
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11.3 ”解析 XML 格式 数据 


通常 情况 下 ,每 个 需要 访问 网 络 的 应 用 程序 都 会 有 一 个 自己 的 服务 器 ,我们 可 以 向 服务 器 提交 
数据 ,也 可 以 从 服务 右上 获取 数据 。 不 过 这 个 时 候 就 出 现 了 一 个 问题 ， 这 些 数 据 到 底 要 以 什么 
样 的 格式 在 网 络 上 传输 呢 ? 随便 传递 一 段 文本 肯定 是 不 行 的 ， 因 为 另 一 方 根本 就 不 知道 这 段 文 
本 的 用 途 是 什么 。 因 此 ， 一 般 我 们 会 在 网 络 上 传输 一 些 格式 化 后 的 数据 ， 这 种 数据 会 有 一 定 的 
结构 规则 和 语义 ， 当 另 一 方 收 到 数据 消息 之 后 ， 就 可 以 按照 相同 的 结构 规则 进行 解析 ， 从 而 取 
出 想 要 的 那 部 分 内 容 。 


在 网 络 上 传输 数据 时 最 常用 的 格式 有 两 种 : XML 和 JSON。 下 面 我 们 就 来 一 个 一 个 地 进行 学 习 。 
本 节 首 先 学 习 一 下 如 何 解 析 XML 格 式 的 数据 。 


在 开始 之 前 ， 我 们 还 需要 先 解 决 一 个 问题 ， 就 是 从 哪儿 才能 获取 一 段 XML 格 式 的 数据 呢 ? 这 里 
我 准备 教 你 搭建 一 个 最 简单 的 Web 服 务 问 ， 在 这 个 服务 器 上 提供 一 段 XML 文 本 ， 然 后 我 们 在 程 
序 里 去 访问 这 个 服务 器 ,再 对 得 到 的 XML 文 本 进行 解析 。 


搭建 Web 服 务 问 的 过 程 其 实 非 常 简单 ， 也 有 很 多 种 服务 问 类 型 可 供 选 择 ， 我 们 准备 使 用 Apache 
服务 戎 。 另 外 ,这 里 只 会 演示 Windows 系 统 下 的 搭建 过 程 ， 因 为 Mac 和 Ubuntu 系统 都 是 默认 
安装 好 Apache 服 务 器 的 ， 只 需要 启动 一 下 即 可 。 如 果 你 使 用 的 是 这 两 种 系统 ， 可 以 自行 搜索 一 
下 具体 的 操作 方法 。 


下 面 来 看 Window 系 统 下 的 搭建 过 程 。 首 先 你 需要 下 载 一 个 Apache 服 务 器 的 安装 包 , 官方 下 载 
地 址 是 : http://httpd.apache.org。 下 载 完成 后 双击 就 可 以 进行 安装 了 ， 如 图 11.3 所 示 。 


Welcome to the Installation Wizard for 
Apache HTIP Server 2.2.9 


The Installation Wizard will install Apache HTTP Server 2.2.9 on 
your computer, To continue, dick Next, 


WARNING: This program is protected by copyright law and 
international treaties. 


图 11.3 ”Apache 服务 器 安装 界面 


然后 一 直 点 击 “Next”， 会 提示 让 你 输入 自己 的 域名 ， 我 们 随便 填 一 个 域名 就 可 以 了 ， 如 图 11.4 
所 未。 
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| Server Information 


Please enter your server's information, 


Network Domain (e.g. somenet,com) 
[test.com 


Server Name (e.g. www.somenet.com): 


[www.test.com 


Administrator's Email Address (e.g. webmaster@somenet,com): 


[testetestcom 


Install Apache HTTP Server 2.2 programs and shortcuts for: 


© for All Users, on Port 80, as a Service -- Recommended, 
S only for the Current User, on Port 8080, when started Manually, 


| Instailshield 


图 11.4 填 入 域名 和 服务 器 信息 


接着 继续 一 直 点 击 “Next”，, 会 提示 让 你 选择 程序 安装 的 路 径 ， 这 里 我 选择 安装 到 C:\Apache 目 
录 下 。 之 后 继续 点 击 “Next” 就 可 以 完成 安装 了 。 安 装 成 功 后 服务 器 会 自动 启动 ,你 可 以 打开 浏 
览 右 来 验证 一 下 。 在 地 址 栏 输入 127.0.0.1， 如 果 出 现 了 如 图 11.5 所 示 的 界面 ， 就 说 明 服务 绒 
已 经 启动 成 功 了 。 
| lo 
DB 127.0.0.1 


TT GC | 127.0.0.1 


It works! 


图 11.5 Apache 服 务 器 的 默认 主页 


接 下 来 进入 C:\Apache\htdocs 目 录 下 ， 在 这 里 新 建 一 个 名 为 get_data.xml 的 文件 ,然后 编辑 
这 个 文件 ， 并 加 入 如 下 XML 格式 的 内 容 。 


<apps> 
<app> 
<id>1</id> 
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<name>Google Maps</name> 
<version>1.0</version> 
</app> 
<app> 
<id>2</id> 
<name>Chrome</name> 
<version>2.1</version> 
</app> 
<app> 
<id>3</id> 
<name>Google Play</name> 
<version>2.3</version> 
</app> 
</apps> 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get_data.xml 这 个 网 址 ,就 应 该 出 现 如 图 11.6 所 示 的 
内 容 。 


[9 127,0,0.1/get dataxm|l x 


所 CC [D127.0.0.1/get data.xml 


This XIL file does not appear to have any style information associated with it. The 
document tree is showm below. 


vapps> 
vapp> 
《id>14 id> 
《name>6oogle Maps</name> 
version? 1. 0C/version> 
</app> 
vapp> 
《id>24 id> 
<name>Chr ome</name> 
《versiorD2. 1</version> 


<Aapp> 
Y《<app> 
《id>3<id> 
<rname>Google Play /name> 
versior?2. 3C/version> 
</app> 
/apps> 


图 11.6 在 浏览 器 验证 XML 数据 
好 了 ， 准备 工作 到 此 结束 ， 接 下 来 就 让 我 们 在 Android 程 序 里 去 获取 并 解析 这 段 XML 数据 吧 。 


11.3.1 Pull 解 析 方 式 


解析 XML 格式 的 数据 其 实 也 有 挺 多 种 方式 的 ， 本 节 中 我 们 学 习 比 较 常用 的 两 种 : Pull 解 析 和 SAX 
解析 。 那 么 简单 起 见 ， 这 里 仍然 是 在 NetworkTest 项 目的 基础 上 继续 开发 ， 这 样 我 们 就 可 以 重 
用 之 前 网 络 通信 部 分 的 代码 ， 从 而 把 工作 的 重心 放 在 XML 数据 解析 上 。 


既然 XML 格 式 的 数据 已 经 提供 好 了 ， 现 在 要 做 的 就 是 从 中 解析 出 我 们 想 要 得 到 的 那 部 分 内 容 。 
修改 MainActivity 中 的 代码 ,如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


private fun sendRequestWithOkHttp() { 
thread { 
try { 
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val client = OkHttpClient() 
val request = Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 计算 机 本 机 
.url("http://10.0.2.2/get data.xml") 
.build() 
val response = client.newCall(request).execute() 
val responseData = response.body?.string() 
if (responseData != null) { 
parseXMLWithPull (responseData) 


} catch (e: Exception) { 
e.printStackTrace() 


} 
} 
} 
private fun parseXMLWithPull(xmlData: String) { 
try { 
val factory = XmlPullParserFactory.newInstance() 
val xmlPullParser = factory.newPullParser() 
xmlPullParser.setInput(StringReader(xmlData)) 
var eventType = xmlPullParser.eventType 
var id = "" 
Var name = "" 
Var version = "" 
while (eventType != XmLPuLLParser ,END _ DOCUMENT) { 
val nodeName = xmlPullParser.name 
when (eventType) { 
// 开始 解析 某 个 节点 
XmLPULLParser .START TAG -> { 
when (nodeName) { 
"id" -> id = xmlPullParser.nextText() 
"name" -> name = xmlPullParser.nextText() 
"version" -> version = xmlPullParser.nextText() 
} 
} 
// 完成 解析 某 个 节点 
XmlPullParser.END TAG -> { 
if ("app" == nodeName) { 
Log.d("MainActivity", "id is $id") 
Log.d("MainActivity", "name is $name") 
Log.d("MainActivity", "version is $version") 
} 
} 
} 
eventType = xmlPullParser.next() 
} catch (e: Exception) { 
e.printStackTrace() 
} 


} 


可 以 看 到 ， 这 里 首先 将 HTTP 请 求 的 地 址 改 成 了 http://10.0.2.2/get data.xml , 10.0.2.2 对 于 
模拟 器 来 说 就 是 计算 机 本 机 的 IP 地 址 。 在 得 到 了 服务 器 返回 的 数据 后 ， 我们 不 再 直接 将 其 展示 ， 
而 是 调用 了 parseXMLWithPull () 方 法 来 解析 服务 器 返回 的 数据 。 


下 面 就 来 仔细 看 下 parseXMLWithPull() 方 法 中 的 代码 吧 。 这 里 首先 要 创建 一 个 
XmLPuLLParserFactory 的 实例 ,并 借助 这 个 实例 得 到 XmLPuLLParser 对 象 ， 然 后 调用 
XmLPuLLParser 的 setInput( ) 方 法 将 服务 器 返回 的 XML 数据 设置 进去 , 之 后 就 可 以 开始 解 
析 了 。 解 析 的 过 程 也 非常 简单 ， 通 过 getEventType ( ) 可 以 得 到 当前 的 解析 事件 ,然后 在 一 个 


www.blogss.cn 


whitLe 循 环 中 不 断 地 进行 解析 ， 如 果 当 前 的 解析 事件 不 等 于 
XmLPuLLParser,.END_DOCUMENT，, 说明 解析 工作 还 没完 成 ， 调 用 next ( ) 方 法 后 可 以 获取 下 
一 个 解析 事件 。 


在 whitLe 循 环 中 ,我 们 通过 getName ( ) 方 法 得 到 了 当前 节点 的 名 字 。 如 果 发 现 节 点 名 等 于 id、 
name 或 version， 就 调用 nextText ( ) 方 法 来 获取 节点 内 具体 的 内 容 ， 每 当 解 析 完 一 个 app 节 
点 ， 就 将 获取 到 的 内 容 打 印 出 来 。 


好 了 ， 整体 的 过 程 就 是 这 么 简单 ， 不 过 在 程序 运行 之 前 还 得 再 进行 一 项 额外 的 配置 。 从 Android 
9.0 系 统 开始 ， 应 用 程序 默认 只 人 允许 使 用 HTTPS 类 型 的 网 络 请 求 ，HTTP 类 型 的 网 络 请 求 因为 有 
安全 隐患 默认 不 再 被 支持 ， 而 我 们 搭建 的 Apache 服 务 屁 现在 使 用 的 就 是 HTTP。 


那么 为 了 能 让 程序 使 用 HTTP， 我 们 还 要 进行 如 下 配置 才 可 以 。 右 击 res 目 录 
New 一 Directory ,创建 一 个 xml 目 录 ， 接着 右 击 xmI 目 录 一 New==File， 创建 一 个 
network_config.xm| 文 件 。 然 后 修改 network_config.xml 文 件 中 的 内 容 , 如 下 所 示 : 


<?xml version="1.0" encoding="utf-8"?> 
<network-security-config> 
<base-config CLeartextTrafficPermitted=" true"> 
<trust-anchors> 
<certificates src="system" /> 
</trust-anchors> 
</base-config> 
</network-security-config> 


这 段 配置 文件 的 意思 就 是 允许 我 们 以 明文 的 方式 在 网 络 上 传输 数据 ， 而 HTTP 使 用 的 就 是 明文 传 
输 方式 。 


接 下 来 修改 AndroidManifest.xml 中 的 代码 来 局 用 我 们 刚才 创建 的 配置 文件 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.networktest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme" 
android:networkSecurityConfig="@xml/network config"> 


</application> 
</manifest> 


这 样 就 可 以 在 程序 中 使 用 HTTP 了 ， 下 面 让 我 们 来 测试 一 下 吧 。 运 行 NetworkTest 项 目 ， 然 后 点 
击 “Send Request" 按 钮 , 观察 Logcat 中 的 打印 日 志 , 如 图 11.7 所 示 。 
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com.example.networktest (14325) 立 Verbose “ 立 


597/com.example.networktest D/MainActivity: id is 1 
597/com.example.networktest D/MainActivity: name is Google Maps 
597/com.example.networktest D/MainActivity: version is 1.0 
597/com.example.networktest D/MainActivity: id is 2 
597/com.example.networktest D/MainActivity: name is Chrome 
597/com.example.networktest D/MainActivity: version is 2.1 
597/com.example.networktest D/MainActivity: id is 3 
597/com.example.networktest D/MainActivity: name is Google Play 
597/com.example.networktest D/MainActivity: version is 2.3 


图 11.7 打印 从 XML 中 解析 出 的 数据 
可 以 看 到 ， 我 们 已 经 将 XML 数据 中 的 指定 内 容 成 功 解析 出 来 了 。 
11.3.2 SAX 解 析 方式 


Pull 解 析 方 式 虽然 非常 好 用 ， 但 它 并 不 是 我 们 唯一 的 选择 。SAX 解 析 也 是 一 种 特别 常用 的 XML 解 
析 方 式 ， 虽 然 它 的 用 法 比 Pull 解 析 要 复杂 一 些 ， 但 在 语义 方面 会 更 加 清楚 。 


要 使 用 SAX 解 析 ， 通常 情况 下 我 们 会 新 建 一 个 类 继承 自 DefauLtHandLer， 并重 写 父 类 的 5 个 
方法 ， 如 下 所 示 : 


class MyHandler : DefaultHandler() { 


override fun startDocument() { 


} 


override fun startElement(uri: String, localName: String, qName: String, attributes: 
Attributes) { 
} 


override fun characters(ch: CharArray, start: Int, length: Int) { 


} 


override fun endElement(uri: String, localName: String, qName: String) { 


} 


override fun endDocument() { 


} 


} 


这 5 个 方法 一 看 就 很 清楚 吧 ? startDocument ( ) 方 法 会 在 开始 XML 解析 的 时 候 调用 ， 
startELement ( ) 方 法 会 在 开始 解析 某 个 节点 的 时 候 调 用 , characters ( ) 方 法 会 在 获取 节点 
中 内 容 的 时 候 调 用 , endELement ( ) 方 法 会 在 完成 解析 某 个 节点 的 时 候 调 用 ， 
endDocument () 方 法 会 在 完成 整个 XML 解析 的 时 候 调 用 。 其 中 , startELement ()、 
characters() 和 endELement () 这 3 个 方法 是 有 参数 的 ， 从 XML 中 解析 出 的 数据 就 会 以 参数 
的 形式 传 入 这 些 方法 中 。 需 要 注意 的 是 ,在 获取 节点 中 的 内 容 时 ,characters ( ) 方 法 可 能 会 
被 调用 多 次 ， 一 些 换行 符 也 被 当 作 内 容 解析 出 来 ， 我 们 需要 针对 这 种 情况 在 代码 中 做 好 控制 。 


那么 下 面 就 让 我 们 尝试 用 SAX 解 析 的 方式 来 实现 和 上 一 小 节 同 样 的 功能 吧 。 新 建 一 个 
ContentHandLer 类 继承 自 DefauLtHandLer ，, 并重 写 父 类 的 5 个 方法 ， 如 下 所 示 : 
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class ContentHandler : DefaultHandler() { 


private var nodeName = 
private lateinit var id: StringBuilder 
private lateinit var name: StringBuilder 
private lateinit var version: StringBuilder 


override fun startDocument() { 
id = StringBuilder() 
name = StringBuilder() 
version = StringBuilder() 


} 


override fun startElement(uri: String, localName: String, qName: String, attributes: 
Attributes) { 
// 记录 当前 节点 名 
nodeName = localName 


Log.d("ContentHandler", "uri is $uri") 
Log.d("ContentHandler", "localName is $localName") 
Log.d("ContentHandler", "qName is $qName") 
Log.d("ContentHandler", "attributes is $attributes") 


} 


override fun characters(ch: CharArray, start: Int, length: Int) { 
// 根据 当前 节点 名 判断 将 内 容 添加 到 J 哪 一 个 StringBuilder 对 象 中 
when (nodeName) { 
"id" -> id.append(ch, start, length) 
"name" -> name.append(ch, start, length) 
"version" -> version.append(ch, start, length) 


} 


override fun endELement(uri: String, localName: String, qName: String) { 
if ("app" == localName) { 

Log.d("ContentHandler", "id is $f{id.toString().trim()}") 
Log.d("ContentHandler", "name is ${name.toString().trim()}") 
Log.d("ContentHandler", "version is ${version.toString().trim()}") 
// 最 后 要 将 StringBuilder 清 空 
id.setLength(0) 
name .setLength(0) 
version.setLength(0) 


} 


override fun endDocument() { 


} 
} 


可 以 看 到 ,我们 首先 给 ijd、name 和 version 节 点 分 别 定 义 了 一 个 StringBuilder 对 象 ， 并 在 
startDocument ( ) 方 法 里 对 它们 进行 了 初始 化 。 每 当 开 始 解析 某 个 节点 的 时 候 ， 
startELement ( ) 方 法 就 会 得 到 调用 ， 其 中 LocaLName 参 数 记录 着 当前 节点 的 名 字 ， 这 里 我 们 
把 它 记 录 下 来 。 接 着 在 解析 节点 中 具体 内 容 的 时 候 就 会 调用 characters ( ) 方 法 ， 我 们 会 根据 
当前 的 节点 名 进行 判断 ， 将 解析 出 的 内 容 添 加 到 哪 一 个 StringBuiLder 对 象 中 。 最 后 在 
endELement ( ) 方 法 中 进行 判断 ， 如 果 app 节 点 已 经 解析 完成 ， 就 打印 出 id、name 和 version 
的 内 容 。 需 要 注意 的 是 ,目前 id、name 和 version 中 都 可 能 是 包括 回 车 或 换行 符 的 ， 因 此 在 打 
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印 之 前 我 们 还 需要 调用 一 人 trim( ) 方 法 ,并 且 打 印 完 成 后 要 将 StringBuilder 的 内 容 清空 ， 
不 然 的 话 会 影响 下 一 次 内 容 的 读 取 。 


接 下 来 的 工作 就 非常 简单 了 ， 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


private fun sendRequestWithOkHttp() { 
thread { 
try { 
val client = OkHttpClient() 
val request = Request.Builder() 
// 指定 访问 的 服务 器 地 址 是 计算 机 本 机 
.url("http://10.0.2.2/get data.xml") 
.build() 
val response = client.newCall(request).execute() 
val responseData = response.body?.string() 
if (responseData != null) { 
parseXMLWithSAX(responseData) 


} catch (e: Exception) { 
e.printStackTrace() 


} 
} 
private fun parseXMLWithSAX(xmlData: String) { 
try { 
val factory = SAXParserFactory.newInstance() 
val xmlReader = factory.newSAXParser().XMLReader 
val handler = ContentHandler() 
// 将 ContentHandLer 的 实例 设置 到 XMLReader 中 
XmLReader .contentHandLer = handler 
// 开始 执行 解析 
XxmLReader.parse(Input9S9ource(StringReader(xmLData) ) ) 
} catch (e: Exception) { 
e.printStackTrace() 
} 
} 


} 


在 得 到 了 服务 器 返回 的 数据 后 ， 我们 这 次 通过 调用 parseXMLWithSAX( ) 方 法 来 解析 XML 数 
据 。parseXMLWithSAX() 方 法 中 先是 创建 了 一 个 SAXParserFactory 的 对 象 ， 然 后 再 获取 
XMLReader 对 象 ， 接着 将 我 们 编写 的 ContentHandler 的 实例 设置 到 XMLReader 中 ,最 后 调 
用 parse( ) 方 法 开始 执行 解析 。 


现在 重新 运行 一 下 程序 , 点 击 “Send Request" 按 钮 后 观察 Logcat 中 的 打印 日 志 ， 你 会 看 到 和 
图 11.7 中 一 样 的 结果 。 


除了 Pull 解 析 和 SAX 解 析 之 外 ， 其实 还 有 一 种 DOM 解 析 方 式 也 比较 常用 ， 不 过 这 里 我 们 就 不 再 
展开 进行 讲解 了 ， 如 果 感 兴趣 的 话 ， 你 可 以 自己 去 查阅 一 下 相关 资料 。 
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11.4 解析 JSON 格 式 数 据 


现在 你 已 经 掌握 了 XML 格 式 数 据 的 解析 方式 ， 那 么 接 下 来 我 们 要 学 习 一 下 如 何 解 析 JSON 格 式 的 
数据 了 。 比 起 XML , JSON 的 主要 优势 在 于 它 的 体积 更 小 ， 在 网 络 上 传输 的 时 候 更 省 流量 。 但 缺 
点 在 于 ， 它 的 语义 性 较 差 ， 看 起 来 不 如 XML 直观 。 


在 开始 之 前 ， 我 们 还 需要 在 C:\Apache\htdocs 目 录 中 新 建 一 个 get_data.json 的 文件 ， 然 后 编 
辑 这 个 文件 ， 并 加 入 如 下 JSON 格 式 的 内 容 : 


[{"id":"5","version":"5.5","name":"Clash of Clans"}, 
{"id":"6","version":"7 
{"id":"7","version":"3. 


.0","name":"Boom Beach"}, 
5","name":"Clash Royale"}] 


这 时 在 浏览 器 中 访问 http://127.0.0.1/get data.json 这 个 网 址 ， 就 应 该 出 现 如 图 11.8 所 示 的 
内 容 。 


各 127.0.0.1/get_datajson x 情 汪 计 
所 © B127.0.0.1/get datajson 
[Ef id 人 Version : “5. 5 ,name“:“Clash of Clans 


人 Version : 0 “name” :“Boom Beach” 
{”id” ”, “version”’:”3.5”, name“ :Clash RO }] 


图 11.8 在 浏览 器 验证 JSON 数 据 


好 了 “， 这样 我 们 就 把 SON 格 式 的 数据 准备 好 了 “， 下面 就 开始 学 习 如 何在 Android 程 序 中 解析 这 
些 数 据 吧 。 


11.4.1 使 用 SONObject 


类 似 地 ， 解析 SON 数 据 也 有 很 多 种 方法 ， 可 以 使 用 官方 提供 的 SONObject， 也 可 以 使 用 
Google 的 开源 库 GSON。 另 外 ， 一 些 第 三 方 的 开源 库 如 jackson、FastjSON 等 也 非常 不 错 。 本 
节 中 我 们 就 来 学 习 一 下 前 两 种 解析 方式 的 用 法 。 


修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
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private fun sendRequestWithOkHttp() { 
thread { 
try { 
val client = OkHttpClient() 
val request = Request.Builder!() 
// 指定 访问 的 服务 器 地 址 是 计算 机 本 机 
.Url("http://10.0.2.2/get data.json") 
.build() 
val response = client.newCall(request).execute() 
val responseData = response.body?.string() 
if (responseData != null) { 
parseJSONWithJSONObject (responseData) 


} catch (e: Exception) { 
e.printStackTrace() 


} 
} 
} 
private fun parseJSONWithJSONObject(jsonData: String) { 
try { 
val jsonArray = JSONArray(jsonData) 
for (i in 0 until jsonArray.length()) { 
val jsonObject = jsonArray.getJSONObject(i) 
val id = jsonObject.getString("id") 
val name = jsonObject.getString("name") 
val version = jsonObject.getString("version") 
Log.d("MainActivity", "id is $id") 
Log.d("MainActivity", "name is $name") 
Log.d("MainActivity", "version is $version") 
} 
} catch (e: Exception) { 
e.printStackTrace() 
} 
} 


首先 将 HTTP 请 求 的 地 址 改 成 http://10.0.2.2/get_data.json， 然 后 在 得 到 服务 器 返回 的 数据 后 
调用 parseJSONWithJSONObject ( ) 方 法 来 解析 数据 。 可 以 看 到 ,解析 JSON 的 代码 真 的 非常 
简单 ， 由 于 我 们 在 服务 器 中 定义 的 是 一 个 JSON 数 组 ， 因 此 这 里 首先 将 服务 器 返回 的 数据 传 入 一 
个 JSONAr ray 对 象 中 。 然 后 循环 遍历 这 个 JSONArray ， 从 中 取出 的 每 一 个 元 素 都 是 一 个 
JSONObject 对 象 ， NOD lee Caf or Ans id name 和 version 这 些 数 据 。 接 下 来 
只 需要 调用 getString() 方 法 将 这 些 数 据 取 出 ， 并 打印 出 来 即 可 。 


好 了 ， 就 是 这 么 简单 ! 现在 重新 运行 一 下 程序 ， 并 点 击 “Send Request” 按 钮 , 结果 如 图 1]1.9 
所 示 。 


com.example.networktest (18274) 地 Verbose “ 习 


0644/com.example.networktest D/MainActivity: id is 5 
0644/com.example.networktest D/MainActivity: name is Clash of Clans 
0644/com.example.networktest D/MainActivity: version is 5.5 
0644/com.example.networktest D/MainActivity: id is 6 
0644/com.example.networktest D/MainActivity: name is Boom Beach 
0644/com.example.networktest D/MainActivity: version is 7.0 
0644/com.example.networktest D/MainActivity: id is 7 
0644/com.example.networktest D/MainActivity: name is Clash Royale 
0644/com.example.networktest D/MainActivity: version is 3.5 


www.blogss.cn 


图 11.9 打印 从 SON 中 解析 出 的 数据 
11.4.2 使 用 GSON 


如 果 你 认为 使 用 SONObject 来 解析 SON 数 据 已 经 非常 简单 了 ， 那 你 就 太 容易 满足 了 7。Google 
提供 的 GSON 开 源 库 可 以 让 解析 JSON 数 据 的 工作 简单 到 让 你 不 敢 想象 的 地 步 ， 那 我 们 肯定 是 不 
能 错过 这 个 学 习 机 会 的 。 


不 过 , GSON 并 没有 被 添加 到 Android 官 方 的 API 中 ， 因 此 如 果 想 要 使 用 这 个 功能 的 话 ， 就 必须 
在 项 目 中 添加 GSON 库 的 依赖 。 编 辑 app/build.gradle 文 件 ,在 dependencies 闭 包 中 添加 如 
下 内 容 : 


dependencies { 


impLementation 'com.google.code.gson:gson:2.8.5' 


那么 GSON 库 究竟 是 神奇 在 哪里 呢 ? 它 的 强大 之 处 就 在 于 可 以 将 一 段 JSON 格 式 的 字符 串 自动 映 
射 成 一 个 对 象 ， 从 而 不 需要 我 们 再 于 动 编写 代码 进行 解析 了 。 


比如 说 一 段 JSON 格 式 的 数据 如 下 所 示 : 


{"name":"Tom","age":20} 


那 我 们 就 可 以 定义 一 个 Person 类 ,并 加 入 name 和 age 这 两 个 字段 , 然后 只 需 简 单 地 调用 如 下 代 
码 就 可 以 将 JSON 数 据 自动 解析 成 一 个 Person 对 象 了 : 


val gson = Gson() 
val person = gson.fromJson(jsonData, Person::class.java) 


如 果 需 要 解析 的 是 一 自 SON 数 组 ， 会 稍微 麻烦 一 点 ， 比 如 如 下 格式 的 数据 : 


om","age":20}, {"name":"Jack","age":25}, {"name":"Lily","age":22}] 


这 个 时 候 ， 我们 需要 借助 TypeToken 将 期 望 解析 成 的 数据 类 型 传 入 fromJson( ) 方 法 中 ,如 下 
所 示 : 


val typeof = object : TypeToken<List<Person>>() {}.type 
val people = gson.fromJson<List<Person>>(jsonData, typeO0f) 


好 了 ， 基 本 的 用 法 就 是 这 样 ， 下 面 就 让 我 们 来 真正 地 尝试 一 下 吧 。 首 先 新 增 一 个 App 类 ,并 加 入 
id、name 和 version 这 3 个 字段 ， 如 下 所 示 : 


class App(val id: String, val name: String, val version: String) 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


private fun sendRequestWithOkHttp() { 
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thread { 
try { 
val client = OkHttpClient() 
val request = Request.Builder!() 
// 指定 访问 的 服务 器 地 址 是 计算 机 本 机 
.url("http://10.0.2.2/get data.json") 
.build() 
val response = client.newCall(request).execute() 
val responseData = response.body?.string() 
if (responseData != null) { 
parseJSONWithGSON(responseData) 


} 
} catch (e: Exception) { 
e.printStackTrace() 
} 


} 


private fun parseJSONWithGSON(jsonData: String) { 

val gson = Gson() 

val typeof = object : TypeToken<List<App>>() {}.type 

val appList = gson.fromJson<List<App>>(jsonData，typeof ) 

for (app in appList) { 
Log.d("MainActivity", "id is ${app.id}") 
Log.d("MainActivity", "name is ${app.name}") 
Log.d("MainActivity", "version is ${app.version}") 


现在 重新 运行 程序 ， 点击“Send Request” 按 钮 后 观察 Logcat 中 的 打印 日 志 ，, 你 会 看 到 和 图 
11.9 中 一 样 的 结果 。 


好 了 ， 这 样 我 们 就 把 XML 和 JSON 这 两 种 数据 格式 最 常用 的 几 种 解析 方法 都 学 习 完 了 ， 在 网 络 数 
据 的 解析 方面 ， 你 已 经 成 功 毕 业 了 。 
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11.5 网络 请 求 回调 的 实现 方式 


目前 你 已 经 掌握 了 HttpURLConnection 和 OkHttp 的 用 法 ， 知道 了 如 何 发 起 HTTP 请 求 ， 以 及 解 
析 服 务 器 返回 的 数据 ， 但 也 许 你 还 没有 发 现 ，, 之 前 我 们 的 写法 其 实 是 很 有 问题 的 。 因 为 一 个 应 
用 程序 很 可 能 会 在 许多 地 方 都 使 用 到 网 络 功 能 ， 而 发 送 HTTP 请 求 的 代码 基本 是 相同 的 ， 如 果 我 
们 每 次 都 去 编写 一 遍 发 送 HTTP 请 求 的 代码 ， 这 显然 是 非常 差劲 的 做 法 。 


没 错 ， 通 常情 况 下 我 们 应 该 将 这 些 通 用 的 网 络 操作 提取 到 一 个 公共 的 类 里 ， 并 提供 一 个 通用 方 
法 ， 当 想 要 发 起 网 络 请 求 的 时 候 ， 只 需 简 单 地 调用 一 下 这 个 方法 即 可 。 比 如 使 用 如 下 的 写法 : 


object HttpUtil { 


fun sendHttpRequest(address: String): String { 

var connection: HttpURLConnection? = null 

try { 
val response = StringBuilder() 
val url = URL(address) 
connection = url.openConnection() as HttpURLConnection 
connection.connectTimeout = 8000 
connection.readTimeout = 8000 
val input = connection.inputStream 
val reader = BufferedReader(InputStreamReader(input)) 
reader.use { 

reader.forEachLine { 
response.append(it) 


return response.toString() 
} catch (e: Exception) { 
e.printStackTrace() 
return e.message.toString() 
} finally { 
connection?.disconnect() 
} 
} 


} 


以 后 每 当 需 要 发 起 一 条 HTTP 请 求 的 时 候 ， 就 可 以 这 样 写 : 


val address = "https://www.baidu.com" 
val response = HttpUtil.sendHttpRequest (address) 


在 获取 到 服务 器 响应 的 数据 后 ， 我们 就 可 以 对 它 进行 解析 和 处 理 了 。 但 是 需要 注意 ， 网 络 请 求 
和 bt 已 


通常 属于 耗 时 操作 ， 而 sendHttpRequest ( ) 方 法 的 内 部 并 没有 开局 线程 ， 这 样 就 有 可 能 导 到 
在 调用 sendHttpRequest ( ) 方 法 的 时 候 主 线程 被 阻塞 。 


你 可 能 会 说 ， 很 简单 咏 ,在 sendHttpRequest ( ) 方 法 内 部 开局 一 个 线程 ， 不 就 解决 这 个 问题 
了 吗 ? 其 实 没有 你 想象 中 那么 容易 ， 因 为 如 果 我 们 在 sendHttpRequest ( ) 方 法 中 开启 一 个 线 
程 来 发 起 HTTP 请 求 ， 服 务 肴 响应 的 数据 是 无 法 进行 返回 的 。 这 是 由 于 所 有 的 耗 时 了 逻 辑 都 是 在 子 
线程 里 进行 的 ,sendHttpRequest () 方 法 会 在 服务 器 还 没 来 得 及 响应 的 时 候 就 执行 结束 了 ， 

当然 也 就 无 法 返回 响应 的 数据 了 。 


www.blogss.cn 


那么 在 遇 到 这 种 情况 时 应 该 怎么 办 呢 ? 其 实 解决 方法 并 不 难 ， 只 需要 使 用 编程 语言 的 回调 机 制 
就 可 以 了 。 下 面 就 让 我 们 来 学 习 一 下 回调 机 制 到 底 是 如 何 使 用 的 。 


首先 需要 定义 一 个 接口 ， 比 如 将 它 命名 成 HttpCallbackListener , 代码 如 下 所 示 : 


interface HttpCallbackListener { 
fun onFinish(response: String) 
fun onError(e: Exception) 


} 


可 以 看 到 ， 我 们 在 接口 中 定义 了 两 个 方法 : onFinish() 方 法 表示 当 服 务 器 成 功 响应 我 们 请 求 
的 时 候 调 用 ,onError( ) 表 示 当 进行 网 络 操作 出 现 错误 的 时 候 调 用 。 这 两 个 方法 都 带 有 参数 ， 
onFinish() 方 法 中 的 参数 代表 服务 器 返回 的 数据 , 而 onError( ) 方 法 中 的 参数 记录 着 错误 的 
详细 信息 。 


接着 修改 HttpUtil 中 的 代码 ， 如 下 所 示 : 


object HttpUtil { 


fun sendHttpRequest(address: String, listener: HttpCallbackListener) { 
thread { 

var connection: HttpURLConnection? = null 

try { 
val response = StringBuilder() 
val url = URL(address) 
connection = url.openConnection() as HttpURLConnection 
connection.connectTimeout = 8000 
connection.readTimeout = 8000 
val input = connection.inputStream 
val reader = BufferedReader(InputStreamReader(input)) 
reader.use { 

reader.forEachLine { 
response.append (it) 


} 


} 
// 回调 onFinish() 方 法 
listener.onFinish(response.toString()) 
} catch (e: Exception) { 
e.printStackTrace() 
// 回调 onError() 方 法 
listener.onError(e) 
} finally { 
connection?.disconnect() 
} 


} 


我 们 首先 给 sendHttpRequest ( ) 方 法 添加 了 一 个 HttpCaLLbackListener 参 数 ， 并 在 方法 
的 内 部 开启 了 一 个 子 线程 ， 然后 在 子 线程 里 执行 具体 的 网 络 操 作 。 注 意 ， 子 线程 中 是 无 法 通过 

return 语 句 返回 数据 的 ， 因 此 这 里 我 们 将 服务 磊 响 应 的 数据 传 入 了 HttpCaLLbackListener 
的 onFinish () 方 法 中 ， 如果 出 现 了 异常 ， 就 将 异常 原因 传 和 onError( ) 方 法 中 。 


现在 sendHttpRequest ( ) 方 法 接收 两 个 参数 ， 因 此 我 们 在 调用 它 的 时 候 还 需要 将 
HttpCallbackListener 的 实例 传 入 ， 如 下 所 示 : 
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HttpUtil.sendHttpRequest(address, object : HttpCallbackListener { 
override fun onFinish(response: String) { 
// 得 到 服务 器 返回 的 具体 内 容 
} 
override fun onError(e: Exception) { 
// 在 这 里 对 异常 情况 进行 处 理 
} 


}) 


这 样 当 服 务 器 成 功 响应 的 时 候 ,我 们 就 可 以 在 onFinish () 方 法 里 对 响应 数据 进行 处 理 了 。 类 
似 地 , 如果 出 现 了 异常 ， 就 可 以 在 onError() 方 法 里 对 异常 情况 进行 处 理 。 如 此 一 来 ， 我们 就 
巧妙 地 利用 回调 机 制 将 响应 数据 成 功 返 回 给 调用 方 了 。 

不 过 你 会 发 现 ,， 上述 使 用 HttpURLConnection 的 写法 总 体 来 说 还 是 比较 复杂 的 ， 那 么 使 用 
OkHttp 会 变 得 简单 吗 ? 答案 是 肯定 的 ， 而且 要 简单 得 多 ， 下面 我 们 来 具体 看 一 下 。 在 HttpUtil 
中 加 入 一 个 send0kHttpRequest ( ) 方 法 ， 如 下 所 示 : 


object HttpUtil { 


fun sendOkHttpRequest(address: String, callback: okhttp3.Callback) { 
val client = OkHttpClient() 
val request = Request.Builder!() 
.url (address) 
.build() 
client.newCall(request).enqueue(callback) 


} 
} 


可 以 看 到 ，sendO0kHttpRequest() 方 法 中 有 一 个 okhttp3.Callback 参 数 ， 这 个 是 OkHttp 
库 中 自 带 的 回调 接口 ， 类 似 于 我 们 刚才 自己 编写 的 HttpCaLLbackListener。 然 后 在 
client.newCall() 之 后 没有 像 之 前 那样 一 直 调 用 execute() 方 法 , 而 是 调用 了 一 个 
enqueue () 方 法 , 并 把 okhttp3.CaLtLback 参 数 传 入 。 相 信和 聪明 的 你 已 经 猜 到 了 , OkHttp 在 
enqueue ( ) 方 法 的 内 部 已 经 帮 有 我 们 开 好 子 线程 了 ， 然 后 会 在 子 线程 中 执行 HTTP 请 求 ， 并 将 最 
终 的 请 求 结果 回调 到 okhttp3 .CaLLback 当 中 。 


那么 我 们 在 调用 send0kHttpRequest ( ) 方 法 的 时 候 就 可 以 这 样 写 : 


HttpUtil.sendOkHttpRequest(address, object : Callback { 
override fun onResponse(call: Call, response: Response) { 
// 得 到 服务 器 返回 的 具体 内 容 
val responseData = response.body?.string() 


} 


override fun onFailure(call: Call, e: IOException) { 
// 在 这 里 对 异常 情况 进行 处 理 
} 
}) 


由 此 可 以 看 出 ，OkHttp 的 接口 设计 得 确实 非常 人 性 化 ， 它 将 一 些 常 用 的 功能 进行 了 很 好 的 封 
装 ， 使 得 我 们 只 需 编写 少量 的 代码 就 能 完成 较为 复杂 的 网 络 操 作 。 


另外 ， 需 要 注意 的 是 ， 不管 是 使 用 HttpURLConnection 还 是 OkHttp， 最终 的 回调 接口 都 还 是 
在 子 线程 中 运行 的 ， 因 此 我 们 不 可 以 在 这 里 执行 任何 的 UI 操作 ， 除 非 借 助 run0nUiThread () 
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方法 来 进行 线程 转换 。 
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11.6 最 好 用 的 网 络 库 : Retrofit 


既然 我 们 这 一 章 讲解 Android 网 络 技 术 ， 那 么 就 不 得 不 提 到 Retrofit， 因 为 它 实在 是 太 好 用 了 。 
Retrofit 同 样 是 一 款 由 Square 公 司 开 发 的 网 络 库 ， 但 是 它 和 OkHttp 的 定位 完全 不 同 。OkHttp 
侧重 的 是 底层 通信 的 实现 ， 而 Retrofit 侧 重 的 是 上 层 接口 的 封装 。 事 实 上 ，Retrofit 就 是 Square 
公司 在 OkHttp 的 基础 上 进一步 开发 出 来 的 应 用 层 网 络 通信 库 ， 使 得 我 们 可 以 用 更 加 面向 对 象 的 
思维 进行 网 络 操作 。Retrofit 的 项 目 主 页 地 址 是 : https://github.com/square/retrofit。 


那么 本 节 我 们 就 来 学 习 一 下 Retrofit 的 用 法 ， 新建 一 个 RetrofitTest 项 目 ， 然 后 马上 开始 吧 。 


11.6.1 Retrofit 的 基本 用 法 
首先 我 想 谈 一 谈 Retrofit 的 基本 设计 思想 。Retrofit 的 设计 基于 以 下 几 个 事实 。 


同一 款 应 用 程序 中 所 发 起 的 网 络 请 求 绝 大 多 数 指向 的 是 同一 个 服务 屁 域 名 。 这 个 很 好 理解 ， 
为 任何 公司 的 产品 ,客户 端 和 服务 器 都 是 配套 的 ， 很 难 想象 一 个 客户 端 一 会 去 这 个 服务 器 获取 
数据 ， 一 会 又 要 去 另外 一 个 服务 肴 获取 数据 吧 ? 


另外 ， 服 务 居 提供 的 接口 通常 是 可 以 根据 功能 来 归 类 的 。 比 如 新 增 用 户 、 修 改 用 户 数据 、 查 询 
用 户 数据 这 几 个 接口 就 可 以 归 为 一 类 ， 上 架 新 书 、 销 售 图书 、 查 询 可 供销 售 图 书 这 几 个 接口 也 
可 以 归 为 一 类 。 将 服务 器 接口 合理 归 类 能 够 让 代码 结构 变 得 更 加 合理 ， 从 而 提高 可 阅读 性 和 可 
维护 性 。 


最 后 ,开发 者 肯定 更 加 习惯 于 “调用 一 个 接口 ， 获取 它 的 返回 值 ”这 样 的 编码 方式 ， 但 当 调用 的 


是 服务 器 接口 时 ， 却 很 难 想象 该 如 何 使 用 这 样 的 编码 方式 。 其 实 大 多 数 人 并 不 关心 网 络 的 具体 
通信 细节 ， 但 是 传统 网 络 库 的 用 法 却 需要 编写 太 多 网 络 相关 的 代码 。 


而 Retrofit 的 用 法 就 是 基于 以 上 几 点 来 设计 的 ,首先 我 们 可 以 配置 好 一 个 根 路 径 ,然后 在 指定 服 
务 器 接口 地 址 时 只 需要 使 用 相对 路 径 即 可 ， 这样 就 不 用 每 次 都 指定 完整 的 URL 地 址 了 。 

另外 ，Retrofit 人 允许 我 们 对 服务 器 接口 进行 归 类 ， 将 功能 同属 一 类 的 服务 性 接 口 定 义 到 同一 个 接 
口 文件 当中 ， 从 而 让 代码 结构 变 得 更 加 合理 。 

最 后 ， 我 们 也 完全 不 用 关心 网 络 通信 的 细节 ,只 需要 在 接口 文件 中 声明 一 系列 方法 和 返回 值 ， 
然后 通过 注解 的 方式 指定 该 方法 对 应 哪个 服务 器 接口 ， 以 及 需要 提供 哪些 参数 。 当 我 们 在 程序 
中 调用 该 方法 时 ，Retrofit 会 自动 向 对 应 的 服务 器 接口 发 起 请 求 ， 并 将 响应 的 数据 解析 成 返回 值 
声明 的 类 型 。 这 就 使 得 我 们 可 以 用 更 加 面向 对 象 的 思维 来 进行 网 络 操作 。 

Retrofit 的 基本 设计 思想 差不多 就 是 这 些 ， 下 面 就 让 我 们 通过 一 个 具体 的 例子 来 快速 体验 一 下 
Retrofit 的 用 法 。 


要 想 使 用 Retrofit， 我 们 需要 先 在 项 目 中 添加 必要 的 依赖 库 。 编 辑 app/build.gradle 文 件 ， 在 
dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 
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impLementation 'com.squareup.retrofit2:retrofit:2.6.1'" 
impLementation "com.sdquareup.retrofit2:converter-gson:2.6.1' 


由 于 Retrofit 是 基于 OkHttp 开 发 的 ， 因此 添加 上 述 第 一 条 依赖 会 自动 将 Retrofit、OkHttp 和 
Okio 这 几 个 库 一 起 下 载 ， 我 们 无 须 再 手动 引入 OKHttp 库 。 另 外 ，Retrofit 还 会 将 服务 妖 返 回 的 
JSON 数 据 自动 解析 成 对 象 ， 因 此 上 述 第 二 条 依赖 就 是 一 个 Retrofit 的 转换 库 ， 它 是 借助 GSON 
来 解析 JSON 数 据 的 ， 所 以 会 自动 将 GSON 库 一 起 下 载 下 来 ， 这 样 我 们 也 不 用 手动 引入 GSON 库 
了 。 除 了 GSON 之 外 ,Retrofit 还 支持 各 种 其 他 主流 的 JSON 解 析 库 ， 包 括 Jjackson、Moshi 等 ， 
不 过 毫 无 疑问 GSON 是 最 常用 的 。 


这 里 我 们 打算 继续 使 用 11.4 节 提供 的 SON 数 据 接 口 。 由 于 Retrofit 会 借助 GSON 将 JSON 数 据 转 
换 成 对 象 ， 因 此 这 里 同样 需要 新 增 一 个 App 类 ， 并 加 入 id、name 和 version 这 3 个 字段 ， 如 下 
所 示 : 


class App(val id: String, val name: String, val version: String) 


接 下 来 ， 我 们 可 以 根据 服务 器 接口 的 功能 进行 归 类 ， 创 建 不 同 种 类 的 接口 文件 ,并 在 其 中 定义 
对 应 具体 服务 器 接口 的 方法 。 不 过 由 于 我 们 的 Apache 服 务 器 上 其 实 只 有 一 个 获取 JSON 数 据 的 
接口 ， 因 此 这 里 只 需要 定义 一 个 接口 文件 ， 并 包含 一 个 方法 即 可 。 新 建 AppService 接 口 ， 代 
码 如 下 所 示 : 


interface AppService { 


@GET("get data.json") 
fun getAppData(): Call<List<App>> 


} 


通常 Retrofit 的 接口 文件 建议 以 具体 的 功能 种 类 名 开头 ， 并 以 Service 结 尾 ， 这 是 一 种 比较 好 的 


命名 习惯 。 


上 述 代 码 中 有 两 点 需要 我 们 注意 。 第 一 就 是 在 getAppData() 方 法 上 面 添 加 的 注解 ， 这 里 使 用 
了 一 个 @GET 注 解 ， 表 示 当 调用 getAppData( ) 方 法 时 Retrofit 会 发 起 一 条 GET 请 求 ， 请 求 的 地 
址 就 是 我 们 在 @GET 注 解 中 传 入 的 具体 参数 。 注 意 ， 这 里 只 需要 传 入 请 求 地 址 的 相对 路 径 即 可 ， 
根 路 径 我 们 会 在 稍 后 设置 。 


第 二 就 是 getAppData( ) 方 法 的 返回 值 必须 声明 成 Retrofit 中 内 置 的 CaLL 类 型 ， 并 通过 泛 型 来 
指定 服务 器 响应 的 数据 应 该 转换 成 什么 对 象 。 由 于 服务 器 响应 的 是 一 个 包含 App 数 据 的 ]JSON 数 
组 ,因此 这 里 我 们 将 泛 型 声明 成 List<App>。 当 然 ，Retrofit 还 提供 了 强大 的 Call Adapters 功 
能 来 允许 我 们 自 定义 方法 返回 值 的 类 型 ， 比 如 Retrofit 结 合 Rxjava 使 用 就 可 以 将 返回 值 声 明成 

0bservabLe、FLowabtLe 等 类 型 ， 不 过 这 些 内 容 就 不 在 本 节 的 讨论 范围 内 了 。 


定义 好 了 AppService 接 口 之 后 ， 接 下 来 的 问题 就 是 该 如 何 使 用 已 。 为 了 方便 测试 ， 我 们 还 得 
在 界面 上 添加 一 个 按钮 才 行 。 修 改 activity_main.xml 中 的 代码 ,如 下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="match parent" 
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android:layout height="match parent" > 


<Button 
android:id="@+id/getAppDataBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Get App Data" /> 


</LinearLayout> 


很 简单 ， 这 里 在 布局 文件 中 增加 了 一 个 Button 控 件 ， 我 们 在 它 的 点 击 事件 中 处 理 具体 的 网 络 请 
求 逻 辑 即 可 。 


现在 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
getAppDataBtn.setOnClickListener { 
val retrofit = Retrofit.Builder() 
.baseUrl("http://10.0.2.2/") 
.addConverterFactory(GsonConverterFactory. create()) 
.build() 
val appService = retrofit.create(AppService::class.java) 
appService.getAppData().enqueue(object : Callback<List<App>> { 
override fun onResponse(call: Call<List<App>>, 
response: Response<List<App>>) { 
val List = response.body() 
if (list != null) { 
for (app in list) { 
Log.d("MainActivity", "id is ${app.id}") 
Log.d("MainActivity", "name is ${app.name}") 
Log.d("MainActivity", "version is ${app.version}") 


} 


override fun onFailure(call: Call<List<App>>, t: Throwable) { 
t.printStackTrace() 


可 以 看 到 ， 在 “Get App Data” 按 钮 的 点 击 事件 当中 ， 首 先 使 用 了 Retrofit .Builder 来 构建 
一 个 Retrofit 对 象 ， 其 中 baseUrl ( ) 方 法 用 于 指定 所 有 Retrofit 请 求 的 根 路 径 ， 
addConverterFactory() 方 法 用 于 指定 Retrofit 在 解析 数据 时 所 使 用 的 转换 库 ， 这 里 指定 成 
GsonConverterFactory。 注 意 这 两 个 方法 都 是 必须 调用 的 。 


有 了 Retrofit 对 象 之 后 ， 我 们 就 可 以 调用 它 的 create () 方 法 ， 并 传 入 具体 Service 接 口 所 对 应 
的 CLass 类 型 ， 创 建 一 个 该 接口 的 动态 代理 对 象 。 如 果 你 并 不 熟悉 什么 是 动态 代理 也 没有 关 

系 ， 你 只 需要 知道 有 了 动态 代理 对 象 之 后 ， 我 们 就 可 以 随意 调用 接口 中 定义 的 所 有 方法 ， 而 
Retrofit 会 自动 执行 具体 的 处 理 就 可 以 了 。 
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对 应 到 上 述 的 代码 当中 ， 当 调用 了 AppService 的 getAppData( ) 方 法 时 ,会 返回 一 个 
CaLL<List<App>> 对 象 ， 这 时 我 们 再 调用 一 下 它 的 enqueue ( ) 方 法 ，Retrofit 就 会 根据 注解 
中 配置 的 服务 器 接口 地 址 去 进行 网 络 请 求 了 ,服务 器 响应 的 数据 会 回调 到 enqueue ( ) 方 法 中 传 
入 的 Callback 实 现 里 面 。 需 要 注意 的 是 ， 当 发 起 请 求 的 时 候 ，Retrofit 会 自动 在 内 部 开启 子 线 
程 ， 当 数据 回调 到 Callback 中 之 后 ，Retrofit 又 会 自动 切换 回 主线 程 ， 整 个 操作 过 程 中 我 们 都 
不 用 考虑 线程 切换 问题 。 在 CaLLback 的 onResponse() 方 法 中 , 调用 response.body() 方 
法 将 会 得 到 Retrofit 解 析 后 的 对 象 ， 也 就 是 List<App> 类 型 的 数据 ,最 后 遍历 List , 将 其 中 的 数 
据 打 印 出 来 即 可 。 


接 下 来 就 可 以 进行 一 下 测试 了 ， 不 过 由 于 这 里 使 用 的 服务 妖 接 口 仍 然 是 HTTP， 因 此 我 们 还 要 按 
照 11.3.1 小 节 所 示 的 步骤 来 进行 网 络 安全 配置 才 行 。 先 从 NetworkTest 项 目 中 复制 
network_config.xm| 文 件 到 RetrofitTest 项 目 当中 ， 然 后 修改 AndroidManifest.xml 中 的 代 
码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.retrofittest"> 


<uses-permission android:name="android,.permission.INTERNET" /> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme" 
android:networkSecurityConfig="@xml/network config"> 


</application> 


</manifest> 


这 里 设置 了 人 允许 使 用 明文 的 方式 来 进行 网 络 请 求 ， 同 时 声明 了 网 络 权 限 。 现 在 运行 RetrofitTest 
项 目 ， 然后 点 击 “Get App Data” 按 钮 , 观察 Logcat 中 的 打印 日 志 ，, 如 图 11.10 所 示 。 


com.example.retrofittest (19325) 地 Verbose “ 闻 


325/com.example.retrofittest D/MainActivity: id is 5 
325/com.example.retrofittest D/MainActivity: name is Clash of Clans 
325/com.example.retrofittest D/MainActivity: version is 5.5 
325/com.example.retrofittest D/MainActivity: id is 6 
325/com.example.retrofittest D/MainActivity: name is Boom Beach 
325/com.example.retrofittest D/MainActivity: version is 7.0 
325/com,exampLe, retrofittest D/MainActivity: id is 7 
325/com.example.retrofittest D/MainActivity: name is Clash Royale 
325/com.example.retrofittest D/MainActivity: version is 3.5 


图 11.10 使 用 Retrofit 请 求 和 解析 出 的 数据 


可 以 看 到 ， 服 务 肴 响应 的 数据 已 经 被 成 功 解析 出 来 了 ， 说 明 我 们 编写 的 代码 确实 已 经 正常 工作 
和 


以 上 就 是 使 用 Retrofit 进 行 网 络 操作 的 基本 用 法 。 虽 然 本 小 节 中 我 们 编写 的 示例 程序 非常 简单 ， 
但 其 实 这 些 都 是 Retrofit 用 法 中 最 常用 且 最 主要 的 部 分 。 在 了 解 了 基本 用 法 之 后 ， 接 下 来 我 们 就 
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可 以 去 学 习 一 些 细节 方面 的 知识 了 。 
11.6.2 处理 复 杂 的 接口 地 址 类 型 


在 上 一 小 节 中 ， 我 们 通过 示例 程序 向 一 个 非常 简单 的 服务 希 接 口 地 址 发 送 请 求 : 
http://10.0.2.2/get_data.json ,然而 在 真实 的 开发 环境 当中 ， 服 务 器 所 提供 的 接口 地 址 不 可 
能 一 直 如 此 简单 。 如 果 你 在 使 用 浏览 器 上 网 时 观察 一 下 浏览 器 上 的 网 址 ,你 会 发 现 这 些 网 址 可 
能 会 是 干 变 万 化 的 ， 那 么 本 小 节 我 们 就 来 学 习 一 下 如 何 使 用 Retrofit 来 应 对 这 些 干 变 万 化 的 情 
况 。 

为 了 方便 举例 ,这 里 先 定义 一 个 Data 类 ,并 包含 id 和 content 这 两 个 字段 , 如 下 所 示 : 


class Data(val id: String, val content: String) 


然后 我 们 先 从 最 简单 的 看 起 ， 比 如 服务 希 的 接口 地 址 如 下 所 示 : 


GET http://example.com/get data.json 


这 是 最 简单 的 一 种 情况 ， 接 口 地 址 是 静态 的 ， 永 远 不 会 改变 。 那 么 对 应 到 Retrofit 当 中 ， 使 用 如 
下 的 写法 即 可 : 


interface ExampleService { 


@GET("get data.json") 
fun getData(): Call<Data> 


这 也 是 我 们 在 上 一 小 节 中 已 经 学 过 的 部 分 ， 理 解 起 来 应 该 非常 简单 吧 。 


但 是 显然 服务 莫不 可 能 总 是 给 我 们 提供 静态 类 型 的 接口 ， 在 很 多 场景 下 ， 接 口 地 址 中 的 部 分 内 
容 可 能 会 是 动态 变化 的 ， 比 如 如 下 的 接口 地 址 : 


GET http://example.com/<page>/get data.json 


在 这 个 接口 当中 ，<page> 部 分 代表 页 数 ， 我 们 传 入 不 同 的 页 数 ， 服 务 莫 返回 的 数据 也 会 不 同 。 
这 种 接口 地 址 对 应 到 Retrofit 当 中 应 该 怎么 写 呢 ? 其 实 也 很 简单 ， 如 下 所 示 : 


interface ExampleService { 


@GET("{page}/get data.json") 
fun getData(@Path("page") page: Int): Call<Data> 


} 


在 @GET 注 解 指定 的 接口 地 址 当中 ， 这 里 使 用 了 一 个 {page} 的 占 位 符 ， 然 后 又 在 getData() 方 
法 中 添加 了 一 个 page 参 数 ， 并 使 用 @Path ("page" ) 注 解 来 声明 这 个 参数 。 这 样 当 调用 
getData ( ) 方 法 发 起 请 求 时 ，Retrofit 就 会 自动 将 page 参 数 的 值 蔡 换 到 占 位 符 的 位 置 ， 从 而 组 
成 一 个 合法 的 请 求 地 址 ， 
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另外 ,很 多 服务 颖 接口 还 会 要 求 我 们 传 入 一 系列 的 参数 ， 格 式 如 下 : 


GET http://example.com/get data.json?u=<user>&t=<token> 


这 是 一 种 标准 的 带 参数 GET 请 求 的 格式 。 接 口 地 址 的 最 后 使 用 问号 来 连接 参数 部 分 ， 每 个 参数 都 
是 一 个 使 用 等 号 连接 的 键 值 对 ， 多 个 参数 之 间 使 用 “& "符号 进行 分 隔 。 那 么 很 显然 ， 在 上 述 地 址 
中 ， 服 务 絮 要 求 我 们 传 入 user 和 token 这 两 个 参数 的 值 。 对 于 这 种 格式 的 服务 兹 接口 ,我们 可 
以 使 用 刚才 所 学 的 @Path 注 解 的 方式 来 解决 ， 但 是 这 样 会 有 些 麻烦 ，Retrofit 针 对 这 种 带 参数 的 
GET 请 求 ， 专门 提 供 了 一 种 语法 支持 : 


interface ExampleService { 


@GET("get data.json") 
fun getData(@Query("u") user: String, @Query("t") token: String): Call<Data> 


这 里 在 getData( ) 方 法 中 添加 了 usSer 和 token 这 两 个 参数 ， 并 使 用 @Query 注 解 对 它们 进行 声 
明 。 这 样 当 发 起 网 络 请 求 的 时 候 ，Retrofit 就 会 自动 按照 带 参 数 GET 请 求 的 格式 将 这 两 个 参数 构 
建 到 请 求 地 址 当中 。 

学 习 了 以 上 内 容 之 后 ， 现 在 你 在 一 定 程度 上 已 经 可 以 应 对 干 变 万 化 的 服务 器 接口 地 址 了 。 不 过 
HTTP 并 不 是 只 有 GET 请 求 这 一 种 类 型 ， 而 是 有 很 多 种 ， 其 中 比较 常用 的 有 GET、P0ST、PUT、 
PATCH、DELETE 这 几 种 。 它 们 之 间 的 分 工 也 很 明确 ， 简 单 概 括 的 话 ，GET 请 求 用 于 从 服务 器 获 
取 数 据 ，P0ST 请 求 用 于 向 服务 器 提交 数据 ，PUT 和 PATCH 请 求 用 于 修改 服务 器 上 的 数据 ， 
DELETE 请 求 用 于 删除 服务 器 上 的 数据 。 


而 Retrofit 对 所 有 常用 的 HTTP 请 求 类 型 都 进行 了 支持 ,使 用 @GET、@P0ST、@PUT、@PATCH、 
@DELETE 注 解 ， 就 可 以 让 Retrofit 发 出 相应 类 型 的 请 求 了 。 


比如 服务 闫 提供 了 如 下 接口 地 址 : 


DELETE http://example.com/data/<id> 


这 种 接口 通常 意味 着 要 根据 id 删除 一 条 指定 的 数据 ， 而 我 们 在 Retrofit 当 中 想 要 发 出 这 种 请 求 就 
可 以 这 样 写 : 


interface ExampleService { 


GDELETE("data/{id}") 
fun deleteData(@Path("id") id: String): Call<ResponseBody> 


} 


这 里 使 用 了 G@DELETE 注 解 来 发 出 DELETE 类 型 的 请 求 ， 并 使 用 了 @Path 注 解 来 动态 指定 id ， 这 些 
都 很 好 理解 。 但 是 在 返回 值 声明 的 时 候 ， 我 们 将 Catt 的 泛 型 指定 成 了 ResponseBody， 这 是 什 
么 意思 呢 ? 
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由 于 P0ST、PUT 、PATCH、DELETE 这 几 种 请 求 类 型 与 GET 请 求 不 同 , 它们 更 多 是 用 于 操作 服 
务 器 上 的 数据 ， 而 不 是 获取 服务 器 上 的 数据 ， 所 以 通常 它们 对 于 服务 器 响应 的 数据 并 不 关心 。 

这 个 时 候 就 可 以 使 用 ResponseBody , 表示 Retrofit 能 够 接收 任意 类 型 的 响应 数据 ， 并 且 不 会 对 
响应 数据 进行 解析 。 


那么 如 果 我 们 需要 向 服务 器 提交 数据 该 怎么 瑟 呢 ? 比如 如 下 的 接口 地 址 : 


POST http://example.com/data/create 
{"id": 1, "content": "The description for this data."} 


使 用 POST 请 求 来 提交 数据 ， 需 要 将 数据 放 到 HTTP 请 求 的 body 部 分 ， 这 个 功能 在 Retrofit 中 可 
以 借助 GBody 注 解 来 完成 : 


interface ExampleService { 


@POST("data/create") 
fun createData(@Body data: Data): Call<ResponseBody> 


} 


可 以 看 到 ， 这 里 我 们 在 createData( ) 方 法 中 声明 了 一 个 Data 类 型 的 参数 ， 并 给 它 加 上 了 
GBody 注 解 。 这 样 当 Retrofit 发 出 P0ST 请 求 时 ， 就 会 自动 将 Data 对 象 中 的 数据 转换 成 SON 格 
式 的 文本 ， 并 放 到 HTTP 请 求 的 body 部 分 ， 服 务 器 在 收 到 请 求 之 后 只 需要 从 body 中 将 这 部 分 数 
据 解 析出 来 即 可 。 这 种 写法 同样 也 可 以 用 来 给 PUT、PATCH、DELETE 类 型 的 请 求 提交 数据 。 


最 后 ,有些 服务 颖 接口 还 可 能 会 要 求 我 们 在 HTTP 请 求 的 header 中 指定 参数 ,比如 : 


GET http://example.com/get data.json 
User-Agent: okhttp 
Cache-Control: max-age=0 


这 些 header 参 数 其 实 就 是 一 个 个 的 键 值 对 ， 我们 可 以 在 Retrofit 中 直接 使 用 GHeaders 注 解 来 
对 它们 进行 声明 。 


interface ExampleService { 


@Headers("User-Agent: okhttp", "Cache-Control: max-age=0") 
@GET("get data.json") 
fun getData(): Call<Data> 


} 


但 是 这 种 写法 只 能 进行 静态 header 声 明 ， 如 果 想 要 动态 指定 header 的 值 ， 则 需要 使 用 
GHeader 注 解 ， 如 下 所 示 : 


interface ExampleService { 


@GET("get data.json") 
fun getData(@Header("User-Agent") userAgent: String, 
@Header("Cache-Control") cacheControl: String): Call<Data> 
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现在 当 发 起 网 络 请 求 的 时 候 ，Retrofit 就 会 自动 将 参数 中 传 入 的 值 设置 到 User-Agent 和 Cache- 
Control 这 两 个 header 当 中 ， 从 而 实现 了 动态 指定 header 值 的 功能 。 


好 了 ， 这 样 我 们 就 将 使 用 Retrofit 处 理 复杂 接口 地 址 类 型 的 内 容 基 本 学 完了 ， 现 在 不 管 服务 器 给 
你 提供 什么 样 类 型 的 接口 ， 相 信 你 都 可 以 从 容 面 对 了 吧 ? 


11.6.3 ”Retrofit 构 建 器 的 最 佳 写法 


学 到 这 里 ， 其 实 还 有 一 个 问题 我 们 没有 正视 过 ， 就 是 获取 Service 接 口 的 动态 代理 对 象 实在 是 
太 麻 烦 了 。 先 回顾 一 下 之 前 的 写法 吧 ， 大 致 代码 如 下 所 示 : 


val retrofit = Retrofit.Builder() 
.baseUrl ("http://10.0.2.2/") 
.addConverterFactory(GsonConverterFactory.create()) 
.build!() 

val appService = retrofit.create(AppService::class.java) 


我 们 想 要 得 有 AppService 的 动态 代理 对 象 ， 需 要 先 使 用 Retrofit.Builder 构 建 出 一 个 
Retrofit 对 象 ， 然 后 再 调用 Retrofit 对 象 的 create ( ) 方 法 创建 动态 代理 对 象 。 如 果 只 是 写 一 次 
还 好 ,每 次 调用 任何 服务 器 接口 时 都 要 这 样 写 一 遍 的 话 ， 肯定 没有 人 能 受 得 了 。 

事实 上 ， 确实 也 没有 每 次 都 写 一 遍 的 必要 ， 因 为 构建 出 的 Retrofit 对 象 是 全 局 通用 的 ， 只 需要 在 
调用 create ( ) 方 法 时 针对 不 同 的 Service 接 口传 入 相应 的 CLas s 类 型 即 可 。 因 此 ， 我 们 可 以 
将 通用 的 这 部 分 功能 封装 起 来 ， 从 而 简化 获取 Service 接 口 动态 代理 对 象 的 过 程 。 

新 建 一 个 ServiceCreator 单 例 类 ， 代 码 如 下 所 示 : 


object ServiceCreator { 
private const val BASE URL = "http://10.0.2.2/" 
private val retrofit = Retrofit.Builder() 
.baseUrl (BASE URL) 
.addConverterFactory(GsonConverterFactory.create()) 
.build() 


fun <T> create(serviceClass: Class<T>): T = retrofit.create(serviceClass) 


} 


这 里 我 们 使 用 obj ect 关 键 字 让 ServiceCreator 成 为 了 一 个 单 例 类 ， 并 在 它 的 内 部 定义 了 一 
个 BASE_URL 常 量 ,用 于 指定 Retrofit 的 根 路 径 。 然 后 同样 是 在 内 部 使 用 Retrofit .BuiLder 
构建 一 个 Retrofit 对 象 ， 注 意 这 些 都 是 用 p rivate 修 饰 符 来 声明 的 ， 相 当 于 对 于 外 部 而 言 它 们 都 
是 不 可 见 的 。 


最 后 ， 我 们 提供 了 一 个 外 部 可 见 的 create () 方 法 ， 并 接收 一 个 CLass 类 型 的 参数 。 当 在 外 部 调 
用 这 个 方法 时 ， 实际 上 就 是 调用 了 Retrofit 对 象 的 Create( ) 方 法 ， 从 而 创建 出 相应 Service 接 
口 的 动态 代理 对 象 。 

经 过 这 样 的 封装 之 后 ，Retrofit 的 用 法 将 会 变 得 异常 简单 ， 比 如 我 们 想 获 取 一 个 AppService 接 
口 的 动态 代理 对 象 ， 只 需要 使 用 如 下 写法 即 可 : 
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val appService = ServiceCreator.create(AppService::class.java) 


之 后 就 可 以 随意 调用 AppService 接 口中 定义 的 任何 方法 了 。 


不 过 上 述 代码 其 实 仍然 还 有 优化 空间 ， 还 记得 我 们 在 上 一 章 的 Kotlin 课 堂 中 学 习 的 泛 型 实 化 功能 
吗 ? 这 里 立马 就 可 以 应 用 起 来 了 。 修 改 ServiceCreator 中 的 代码 , 如 下 所 示 : 


object ServiceCreator { 


inline fun <reified T> create(): T = create(T::class.java) 


可 以 看 到 ,我们 又 定义 了 一 个 不 带 参 数 的 create( ) 方 法 ， 并 使 用 inLine 关 键 字 来 修饰 方法 ， 
使 用 reified 关 键 字 来 修饰 泛 型 ,这 是 泛 型 实 化 的 两 大 前 提 条 件 。 接 下 来 就 可 以 使 用 
T: :class .java 这 种 语法 了 ， 这 里 调用 刚才 定义 的 带 有 Class 参 数 的 create( ) 方 法 即 可 。 


那么 现在 我 们 就 又 有 了 一 种 新 的 方式 来 获取 AppService 接 口 的 动态 代理 对 象 ， 如 下 所 示 : 


val appService = ServiceCreator.create<AppService>() 


代码 是 不 是 变 得 更 加 简洁 了 ? 
好 了 ， 关 于 Retrofit 的 使 用 就 先 讲 到 这 里 ， 我 们 会 在 第 15 章 的 实战 环节 学 习 如 何在 实际 的 项 目 


当中 应 用 Retrofit。 那 么 接 下 来 ， 又 该 进入 本 章 的 Kotlin 课 堂 了 ,这 次 我 们 来 学 习 一 项 特别 神奇 
的 技术 一 一 协 程 。 
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11.7 Kotlin 课 堂 : 使 用 协 程 编写 高 效 的 并 发 程序 

协 程 属于 Kotlin 中 非常 有 特色 的 一 项 技术 ， 因 为 大 部 分 编程 语言 中 是 没有 协 程 这 个 概念 的 。 
那么 什么 是 协 程 呢 ? 它 其 实 和 线程 是 有 点 类 似 的 ， 可 以 简单 地 将 它 理 解 成 一 种 轻 量 级 的 线程 。 
要 知道 ， 我们 之 前 所 学 习 的 线程 是 非常 重量 级 的 ， 它 需要 依靠 操作 系统 的 调度 才能 实现 不 同 线 
程 之 间 的 切换 。 而 使 用 协 程 却 可 以 仅 在 编程 语言 的 层面 就 能 实现 不 同 协 程 之 间 的 切换 ， 从 而 大 
大 提升 了 并 发 编程 的 运行 效率 。 


举 一 个 具体 点 的 例子 ， 比 如 我 们 有 如 下 foo() 和 bar( ) 两 个 方法 : 


fun foo() { 
al() 
b() 
c() 

} 

fun bar() { 
x() 
y() 
z() 

} 


在 没有 开局 线程 的 情况 下 ， 先 后 调用 foo ( ) 和 bar( ) 这 两 个 方法 ,那么 理论 上 结果 一 定 是 a()、 
b()、c() 执 行 完了 以 后 , x()、y()、z() 才 能 够 得 到 执行 。 而 如 果 使 用 了 协 程 ， 在 协 程 A 中 去 
调用 foo ( ) 方 法 ， 协 程 B 中 去 调用 bar ( ) 方 法 ， 虽 然 它 们 仍然 会 运行 在 同一 个 线程 当中 ， 但 是 在 
执行 foo ( ) 方 法 时 随时 都 有 可 能 被 挂 起 转 而 去 执行 bar ( ) 方 法 ， 执 行 bar ( ) 方 法 时 也 随时 都 有 
可 能 被 挂 起 转 而 继续 执行 foo ( ) 方 法 ， 最 终 的 输出 结果 也 就 变 得 不 确定 了 。 

可 以 看 出 ， 协 程 允许 我 们 在 单线 程 模式 下 模拟 多 线程 编程 的 效果 ， 代码 执行 时 的 挂 起 与 恢复 完 
全 是 由 编程 语言 来 控制 的 ， 和 操作 系统 无 关 。 这 种 特性 使 得 高 并 发 程序 的 运行 效率 得 到 了 极 大 
的 提升 ， 试 想 一 下 ， 开 局 10 万 个 线程 完全 是 不 可 想象 的 事 吧 ? 而 开启 10 万 个 协 程 就 是 完全 可 行 
的 ， 待 会 我 们 就 会 对 这 个 功能 进行 验证 。 


现在 你 已 经 了 解 了 协 程 的 一 些 基本 概念 ， 那 么 接 下 来 我 们 就 开始 学 习 Kotlin 中 协 程 的 用 法 。 
11.7.1 协 程 的 基本 用 法 


Kotlin 并 没有 将 协 程 纳 入 标准 库 的 API 当 中 ， 而 是 以 依赖 库 的 形式 提供 的 。 所 以 如 果 我 们 想 要 使 
用 协 程 功 能 ， 需 要 先 在 app/build.gradle 文 件 当 中 添加 如 下 依赖 库 : 


dependencies { 


implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.1.1" 
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.1.1" 


第 二 个 依赖 库 是 在 Android 项 目 中 才 会 用 到 的 ， 本 节 我 们 编写 的 代码 示例 都 是 纯 Kotlin 程 序 ， 所 
以 其 实用 不 到 第 二 个 依赖 库 。 但 为 了 下 次 在 Android 项 目 中 使 用 协 程 时 不 再 单独 进行 说 明 ， 这 里 
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就 一 同 引入 进来 了 。 


接 下 来 创建 一 个 CoroutinesTest.kt 文 件 ， 并 定义 一 个 main( ) 函 数 ， 然 后 开始 我 们 的 协 程 之 旅 
吧 。 


首先 我 们 要 面临 的 第 一 个 问题 就 是 ,如 何 开 启 一 个 协 程 ? 最 简单 的 方式 就 是 使 用 
GLobatL.Launch 范 数 , 如 下 所 示 : 


fun main() { 
GlobalScope.launch { 
println("codes run in coroutine scope") 


GlLobalScope. Launch 消 数 可 以 创建 一 个 协 程 的 作用 域 ， 这样 传 递 给 Launch 消 数 的 代码 块 
(Lambda 表 达 式 ) 就 是 在 协 程 中 运行 的 了 ， 这 里 我 们 只 是 在 代码 块 中 打印 了 一 行 日 志 。 那 么 
现在 运行 nain( ) 组 数 ， 日 志 能 成 功 打印 出 来 吗 ? 如 果 你 尝试 一 下 ， 会 发 现 没有 任何 日 志和 输出 。 


这 是 因为 ，GLobaL.Launch 函 数 每 次 创建 的 都 是 一 个 顶层 协 程 ， 这 种 协 程 当 应 用 程序 运行 结束 
时 也 会 跟着 一 起 结束 。 刚 才 的 日 志 之 所 以 无 法 打印 出 来 ， 就 是 因为 代码 块 中 的 代码 还 没 来 得 及 
运行 ,应 用 程序 就 结束 了 。 


要 解决 这 个 问题 也 很 简单 ， 我 们 让 程序 延迟 一 段 时 间 再 结束 就 行 了 ， 如 下 所 示 : 


fun main() { 
GlobalScope.launch { 
println("codes run in coroutine scope") 


} 
Thread.sleep(1000) 


} 


这 里 使 用 Thread .sleep() 方 法 让 主线 程 阻塞 1 秒 钟 ， 现在 重新 运行 程序 ， 你 会 发 现 日 志 可 以 
正常 打印 出 来 了 ， 如 图 11.11 所 示 。 


Run: _app com.example.retrofittest.CoroutinesTest... 
> "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
codes run in coroutine scope 


Process finished with exit code 0 


图 11.11 在 协 程 中 打印 日 志 


可 是 这 种 写法 还 是 存在 问题 ， 如 果 代 码 块 中 的 代码 在 1 秒 钟 之 内 不 能 运行 结束 ， 那 么 就 会 被 强制 
中 断 。 观 察 如 下 代码 : 


fun main() { 
GlobalScope.launch { 
println("codes run in coroutine scope") 
delay(1500) 
println("codes run in coroutine scope finished") 


} 
Thread. sleep(1000) 
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我 们 在 代码 块 中 加 入 了 一 个 deLay () 国 数 , 并 在 之 后 又 打印 了 一 行 日 志 。detLay ( ) 函 数 可 以 让 
当前 协 程 延迟 指定 时 间 后 再 运行 ,但 它 和 Thread .sleep() 方 法 不 同 。delay ( ) 函 数 是 一 个 非 
阻塞 式 的 挂 起 函数 , 它 只 会 挂 起 当前 协 程 ， 并 不 会 影响 其 他 协 程 的 运行 。 而 Thread ,sLeep ( ) 
方法 会 阻塞 当前 的 线程 ， 这 样 运行 在 该 线程 下 的 所 有 协 程 都 会 被 阻塞 。 注 意 ，delay () 范 数 只 
能 在 协 程 的 作用 域 或 其 他 挂 起 函数 中 调用 。 


这 里 我 们 让 协 程 挂 起 1.5 秒 ， 但 是 主线 程 却 只 阻塞 了 1 秒 ， 最终 会 是 什么 结果 呢 ? 重新 运行 程 
序 ， 你 会 发 现代 码 块 中 新 增 的 一 条 日 志 并 没有 打印 出 来 ， 因 为 它 还 没 能 来 得 及 运行 ， 应 用 程序 
就 已 经 结束 了 。 


那么 有 没有 什么 办 法 能 让 应 用 程序 在 协 程 中 所 有 代码 都 运行 完了 之 后 再 结束 呢 ? 当然 也 是 有 
的 ,借助 runBLocking 函 数 就 可 以 实现 这 个 功能 : 


fun main() { 
runBlocking { 
println("codes run in coroutine scope") 
delay(1500) 
println("codes run in coroutine scope finished") 


} 


runBLocking 函 数 同样 会 创建 一 个 协 程 的 作用 域 ， 但 是 它 可 以 保证 在 协 程 作用 域内 的 所 有 代码 
和 子 协 程 没有 全 部 执行 完 之 前 一 直 阻 塞 当前 线程 。 需 要 注意 的 是 ,runBLocking 顺 数 通常 只 应 
该 在 测试 环境 下 使 用 ,在 正式 环境 中 使 用 容易 产生 一 些 性 能 上 的 问题 。 


现在 重新 运行 程序 , 结果 如 图 11.12 所 示 。 


Run: ,app ~ com.example.retrofittest.CoroutinesTest... 

"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
codes run in coroutine scope 

codes run in coroutine scope finished 


Process finished with exit code 0 


Yl 


图 11.12 runBLocking 函 数 的 运行 效果 

可 以 看 到 ， 两 条 日 志 都 能 够 正常 打印 出 来 了 。 

虽说 现在 我 们 已 经 能 够 让 代码 在 协 程 中 运行 了 ， 可 是 好 像 并 没有 体会 到 什么 特别 的 好 处 。 这 是 
因为 目前 所 有 的 代码 都 是 运行 在 同一 个 协 程 当中 的 ， 而 一 旦 涉及 高 并 发 的 应 用 场景 ， 协 程 相 比 
于 线程 的 优势 就 能 体现 出 来 了 。 

那么 如 何 才能 创建 多 个 协 程 呢 ? 很 简单 ， 使 用 Launch 函 数 就 可 以 了 ， 如 下 所 示 : 


fun main() { 
runBlocking { 
launch { 
println("Launch1") 
delay(1000) 
printtn("Launch1l finished") 


} 
launch { 
println("Llaunch2") 
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deLay(1000 ) 
printLn("Launch2 finished") 


注意 这 里 的 Launch 也 数 和 我 们 刚才 所 使 用 的 6LobalScope .launch 沙 数 不 同 。 首 先 它 必须 在 
协 程 的 作用 域 中 才能 调用 ， 其 次 它 会 在 当前 协 程 的 作用 域 下 创建 子 协 程 。 子 协 程 的 特点 是 如 果 
外 层 作用 域 的 协 程 结束 了 ， 该 作用 域 下 的 所 有 子 协 程 也 会 一 同 结束 。 相 比 而 言 ， 
GlobalScope .launch 消 数 创 建 的 永远 是 顶层 协 程 ， 这 一 点 和 线程 比较 像 ， 因 为 线程 也 没有 层 
级 这 一 说 ,永远 都 是 顶层 的 。 


这 里 我 们 调用 了 两 次 Launch 消 数 ， 也 就 是 创建 了 两 个 子 协 程 。 重 新 运行 程序 ， 结 果 如 图 11.13 
所 未。 


Run: ,app ~ com.example.retrofittest.CoroutinesTest... 

p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
Launch1 
Launch2 


launch1 finished 
Launch2 finished 


le dl 


Process finished with exit code 0 
图 11.13 多 个 协 程 并 发 运行 的 效果 


可 以 看 到 ， 两 个 子 协 程 中 的 日 志 是 交 蔡 打 印 的 ， 说 明 它们 确实 是 像 多 线程 那样 并 发 运行 的 。 然 
而 这 两 个 子 协 程 实际 却 运行 在 同一 个 线程 当中 ， 只 是 由 编程 语言 来 决定 如 何在 多 个 协 程 之 间 进 
行 调度 ， 让 谁 运行 ， 让 谁 挂 起 。 调 度 的 过 程 完全 不 需要 操作 系统 参与 ， 这 也 就 使 得 协 程 的 并 发 
效率 会 出 奇 得 高 。 


那么 具体 会 有 多 高 呢 ? 我 们 来 做 下 实验 就 知道 了 ， 代 码 如 下 所 示 : 


fun main() { 
val start = System.currentTimeMillis() 
runBlocking { 
repeat(100000) { 
launch { 
println(".") 


} 


val end = System.currentTimeMillis() 
println(end - start) 


} 


这 里 使 用 repeat 池 数 循环 创建 了 10 万 个 协 程 ， 不 过 在 协 程 当中 并 没有 进行 什么 有 意义 的 操作 ， 
只 是 象征 性 地 打印 了 一 个 点 ， 然 后 记录 一 下 整个 操作 的 运行 耗 时 。 现 在 重新 运行 一 下 程序 , 结 
果 如 图 11.14 所 示 。 
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Run: app ~ com.example.retrofittest.CoroutinesTest... 


le YJ 


办 961 


Process finished with exit code 0 
图 11.14 10 万 个 协 程 并 发 的 运行 效率 


可 以 看 到 ， 这 里 仅仅 耗 时 了 961 之 秒 ， 这 足以 证 明 协 程 有 多 么 高 效 。 试 想 一 下 ， 如 果 开 启 的 是 
10 万 个 线程 ， 程 序 或 许 已 经 出 现 OOM 有 异常 了 。 


不 过 ， 随 着 Launch 函 数 中 的 逻辑 越 来 越 复杂 ， 可 能 你 需要 将 部 分 代码 提取 到 一 个 单独 的 函数 
中 。 这 个 时 候 就 产生 了 一 个 问题 : 我 们 在 Launch 函 数 中 编写 的 代码 是 拥有 协 程 作用 域 的 ， 但 是 
提取 到 一 个 单独 的 函数 中 就 没有 协 程 作用 域 了 ,那么 我 们 该 如 何 调用 像 delay ( ) 这 样 的 挂 起 函 
数 呢 ? 


为 此 Kotlin 提 供 了 一 个 suspend 关 键 字 ， 使 用 它 可 以 将 任意 函数 声明 成 挂 起 函数 ， 而 挂 起 函数 
之 间 都 是 可 以 互相 调用 的 ， 如 下 所 示 : 


gl 中 


suspend fun printDot() { 
println(".") 
delay(1000) 

} 


这 样 就 可 以 在 printDot ( ) 函数 中 调用 deLay ( ) 函数 了 。 


但 是 ,suspend 关 键 字 只 能 将 一 个 函数 声明 成 挂 起 函数 ， 是 无 法 给 它 提供 协 程 作用 域 的 。 比 如 
你 现在 尝试 在 printDot ( ) 函数 中 调用 Launch 函 数 ， 一 定 是 无 法 调用 成 功 的 ， 因 为 Launch 函 
数 要 求 必须 在 协 程 作用 域 当 中 才能 调用 。 


这 个 问题 可 以 借助 coroutineScope 上 函数 来 解决 。coroutineScope 函 数 也 是 一 个 挂 起 函数 ， 
因此 可 以 在 任何 其 他 挂 起 函数 中 调用 。 它 的 特点 是 会 继承 外 部 的 协 程 的 作用 域 并 创建 一 个 子 协 
程 ， 借 助 这 个 特性 ， 我 们 就 可 以 给 任意 挂 起 函数 提供 协 程 作用 域 了 。 示 例 写法 如 下 : 


suspend fun printDot() = coroutineScope { 
launch { 
println(".") 
delay (1000) 
中 


可 以 看 到 ， 现 在 我 们 就 可 以 在 printDot ( ) 这 个 挂 起 函数 中 调用 Launch 涵 数 了 。 
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另外 ,coroutineScope 函 数 和 runBLocking 函 数 还 有 点 类 似 ， 它 可 以 保证 其 作用 域内 的 所 
有 代码 和 子 协 程 在 全 部 执行 完 之 前 ， 外 部 的 协 程 会 一 直 被 挂 起 。 我 们 来 看 如 下 示例 代码 : 
fun main() { 


runBlocking { 
coroutineScope { 


launch { 
for (i in 1..10) { 
println(i) 
delay (1000) 
} 


println("coroutineScope finished") 


printLn("runBLocking finished") 


这 里 先 使 用 runBLocking 函 数 创 建 了 一 个 协 程 作用 域 ， 然 后 调用 coroutineScope 上 函数 创建 
了 一 个 子 协 程 。 在 coroutineScope 的 作用 域 中 ， 我们 又 调用 Launch 函 数 创建 了 一 个 子 协 
程 ， 并 通过 for 循 环 依次 打印 数字 1 到 10 ,每 次 打印 间隔 一 秒 钟 。 最 后 在 runBLocking 和 
coroutineScope 函 数 的 结尾 ,分 别 又 打印 了 一 行 日 志 。 现 在 重新 运行 一 下 程序 ,结果 如 图 
11.15 所 示 。 


Run: ,app ~ com.example.retrofittest.CoroutinesTest... 
> "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java”" ... 
1 
2 
人 
了 | 4 
和 
尘 | 6 
= 六 
el 8 
= " 入 
coroutineScope finished 
办 runBlocking finished 


Process finished with exit code 0 


图 11.15 coroutineScope 函 数 的 运行 效果 


你 会 看 到 ， 控 制 台 会 以 1 秒 钟 的 间隔 依次 输出 数字 1 到 10 ,然后 才 会 打印 coroutineScope 攀 
数 结尾 的 日 志 , 最 后 打印 runBLlocking 泌 数 结尾 的 日 志 。 


由 此 可 见 ,coroutineScope 函 数 确实 是 将 外 部 协 程 挂 起 了 ， 只 有 当 它 作用 域内 的 所 有 代码 和 
子 协 程 都 执行 完毕 之 后 ，coroutineScope 函 数 之 后 的 代码 才能 得 到 运行 。 


虽然 看 上 去 coroutineScope 函 数 和 runBLocking 函 数 的 作用 是 有 点 类 似 的 ， 但 是 
coroutineScope 函 数 只 会 阻塞 当前 协 程 ， 既 不 影响 其 他 协 程 ， 也 不 影响 任何 线程 ， 因 此 是 不 
会 造成 任何 性 能 上 的 问题 的 。 而 runBLocking 函 数 由 于 会 挂 起 外 部 线程 ， 如 果 你 恰好 又 在 主线 
程 中 当中 调用 它 的 话 ， 那 么 就 有 可 能 会 导致 界面 卡 死 的 情况 ， 所 以 不 太 推荐 在 实际 项 目 中 使 
用 。 
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好 了 ， 现 在 我 们 就 将 协 程 的 基本 用 法 都 学 习 完了 ， 你 也 算是 已 经 成 功 入 门 了 。 那 么 接 下 来 ， 就 
让 我 们 开始 学 习 协 程 更 多 的 知识 吧 。 


11.7.2 更 多 的 作用 域 构建 器 


在 上 一 小 节 中 ,我 们 学 习 了 GlobalScope.launch、runBlocking、launch.、 
coroutineScope 这 几 种 作用 域 构 建 器 ,它们 都 可 以 用 于 创建 一 个 新 的 协 程 作用 域 。 不 过 
GLobaLScope.Launch 和 runBLocking 函 数 是 可 以 在 任意 地 方 调 用 的 ,coroutineScope 国 
数 可 以 在 协 程 作用 域 或 挂 起 函数 中 调用 ,而 Launch 叉 数 只 能 在 协 程 作 用 域 中 调用 。 


前 面 已 经 说 了 ，runBLocking 由 于 会 阻塞 线程 ， 因 此 只 建议 在 测试 环境 下 使 用 。 而 
GlobalScope.1launch 由 于 每 次 创建 的 都 是 顶层 协 程 ， 一般 也 不 太 建 议 使 用 ， 除 非 你 非常 明确 
就 是 要 创建 顶层 协 程 。 

为 什么 说 不 太 建议 使 用 顶层 协 程 呢 ? 主要 还 是 因为 它 管理 起 来 成 本 太 高 了 。 举 个 例子 ， 比 如 我 
们 在 某 个 Activity 中 使 用 协 程 发 起 了 一 条 网 络 请 求 ， 由 于 网 络 请 求 是 耗 时 的 ， 用 户 在 服务 问 还 没 
来 得 及 响应 的 情况 下 就 关闭 了 当前 Activity， 此 时 按理 说 应 该 取消 这 条 网 络 请 求 ， 或 者 至 少 不 应 
该 进行 回调 ， 因 为 Activity 已 经 不 存在 了 ， 回调 了 也 没有 意义 。 


那么 协 程 要 怎样 取消 呢 ? 不 管 是 GLobaLScope ,Launch 函 数 还 是 Launch 函 数 , 它们 都 会 返回 
一 个 Job 对 象 ， 只 需要 调用 job 对 象 的 cancetL( ) 方 法 就 可 以 取消 协 程 了 ,如 下 所 示 : 


val job = GlobalScope.launch { 
// 处 理 具体 的 逻辑 
} 


job.cancel() 


但 是 如 有 果 我 们 每 次 创建 的 都 是 顶层 协 程 ， 那 么 当 Activity 关 闭 时 ， 就 需要 逐个 调用 所 有 已 创建 协 
程 的 cancel () 方 法 ,试想 一 下 ， 这样 的 代码 是 不 是 根本 无 法 维护 ? 


因此 ，GLobaLScope,Launch 这 种 协 程 作用 域 构建 器 ， 在 实际 项 目 中 也 是 不 太 常用 的 。 下 面 我 
来 演示 一 下 实际 项 目 中 比较 常用 的 写法 : 


val job = Job() 
val scope = CoroutineScope(job) 
scope.launch { 

// 处 理 具体 的 逻辑 


job.cancel() 


可 以 看 到 ， 我们 先 创建 了 一 个 ]ob 对 象 ， 然 后 把 它 传 入 CoroutineScope( ) 函 数 当 中 ， 注 意 这 
里 的 CoroutineScope() 是 个 函数 ,虽然 它 的 命名 更 像 是 一 个 类 。CoroutineScope () 函 数 
会 返回 一 个 CoroutineScope 对 象 ， 这 种 语法 结构 的 设计 更 像 是 我 们 创建 了 一 个 
CoroutineScope 的 实例 ， 可 能 也 是 Kotlin 有 意 为 之 的 。 有 了 CoroutineScope 对 象 之 后 ， 就 
可 以 随时 调用 它 的 Launch 函 数 来 创建 一 个 协 程 了 。 


现在 所 有 调用 CoroutineScope 的 Launch 了 水 数 所 创建 的 协 程 ,都 会 被 关联 在 J]ob 对 象 的 作用 域 
下 面 。 这 样 只 需要 调用 一 次 cancel() 方 法 ,就 可 以 将 同一 作用 域内 的 所 有 协 程 全 部 取消 ， 从 而 


www.blogss.cn 


大 大 降低 了 协 程 管理 的 成 本 。 


不 过 相 比 之 下 ，CoroutineScope( ) 水 数 更 适合 用 于 实际 项 目 当中 ， 如 果 只 是 在 main( ) 组 数 
中 编写 一 些 学 习 测 试用 的 代码 ， 还 是 使 用 runBLocking 函 数 最 为 方便 。 


协 程 的 内 容 确实 比较 多 ， 下 面 我 们 还 要 继续 学 习 。 你 已 经 知道 了 调用 Launch 函 数 可 以 创建 一 个 
新 的 协 程 ， 但 是 Launch 函 数 只 能 用 于 执行 一 段 逻辑 ， 却 不 能 获取 执行 的 结果 ,因为 它 的 返回 值 
永远 是 一 个 Job 对 象 。 那 么 有 没有 什么 办 法 能 够 创建 一 个 协 程 并 获取 它 的 执行 结果 呢 ? 当然 有 ， 
使 用 async 函 数 就 可 以 实现 。 


async 函 数 必 须 在 协 程 作 用 域 当中 才能 调用 ，, 它 会 创建 一 个 新 的 子 协 程 并 返回 一 个 Deferred 对 
象 ， 如 果 我 们 想 要 获取 async 函 数 代码 块 的 执行 结果 , 只 需要 调用 Deferred 对 象 的 await( ) 
方法 即 可 ， 代 码 如 下 所 示 : 


fun main() { 
runBlocking { 
val result = async { 
5+5 
}.await() 
println(result) 


} 
这 里 我 们 在 async 上 函数 的 代码 块 中 进行 了 一 个 简单 的 数学 运算 ， 然 后 调用 await ( ) 方 法 获取 运 
算 结 果 ， 最终 将 结果 打印 出 来 。 重 新 运行 一 下 代码 ， 结 果 如 图 11.16 所 示 。 


Run: _app com.example.retrofittest.CoroutinesTest.. 


> "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
10 
Process finished with exit code 0 
区 
图 11.16 打印 async 函 数 的 执行 结果 


不 过 async 函 数 的 奥秘 还 不 止 于 此 。 事 实 上 ， 在 调用 了 async 因 数 之 后 ， 代 码 块 中 的 代码 就 会 
立刻 开始 执行 。 当 调用 await ( ) 方 法 时 ,如 果 代 码 块 中 的 代码 还 没 执行 完 , 那么 await( ) 方 法 
会 将 当前 协 程 阻塞 住 ， 直到 可 以 获得 async 因 数 的 执行 结果 。 


为 了 证 实 这 一 点 ， 我 们 编写 如 下 代码 进行 验证 : 


fun main() { 
runBlocking { 
val start = System.currentTimeMillis() 
val resultl1 = async { 
delay(1000) 
5: 二 -5 
}.await() 
val result2 = async { 
delay(1000) 
4+6 
}.await() 
println("result is ${resultl1l + result2}.") 
val end = System.currentTimeMillis() 
println("cost ${fend - start} ms.") 


www.blogss.cn 


} 


这 里 连续 使 用 了 两 个 async 函 数 来 执行 任务 ， 并 在 代码 块 中 调用 deLay ( ) 方 法 进行 1 秒 的 延迟 。 
按照 刚才 的 理论 ，await ( ) 方 法 在 async 函 数 代码 块 中 的 代码 执行 完 之 前 会 一 直 将 当前 协 程 阴 
塞 住 ， 那么 为 了 便于 验证 ， 我 们 记录 了 代码 的 运行 耗 时 。 现 在 重新 运行 程序 ,结果 如 图 11.17 所 
不 。 


Run: _app ~ com.example.retrofittest.CoroutinesTest... 


"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
result is 20， 
cost 2032 ms. 


,Process finished with exit code 0 


图 11.17 ”async 函 数 串 行 运行 耗 时 


可 以 看 到 ， 整 段 代 码 的 运行 耗 时 是 2032 富 秒 ， 说 明 这 里 的 两 个 async 函 数 确实 是 一 种 串 行 的 关 
系 ， 前 一 个 执行 完了 后 一 个 才能 执行 。 


但 是 这 种 写法 明显 是 非常 低 效 的 ， 因 为 两 个 async 函 数 完全 可 以 同时 执行 从 而 提高 运行 效率 。 
现在 对 上 述 代码 使 用 如 下 的 写法 进行 修改 : 


fun main() { 
runBlocking { 
val start = System.currentTimeMillis() 
val deferredl = async { 


delay(1000) 
5+5 
} 
val deferred2 = async { 
delay(1000) 
4+6 


println("result is ${deferredl.await() + deferred2.await()}.") 
val end = System.currentTimeMillis() 
println("cost ${fend - start} milliseconds.") 


} 


现在 我 们 不 在 每 次 调用 async 国 数 之 后 就 立刻 使 用 await ( ) 方 法 获取 结果 了 ， 而 是 仅 在 需要 用 
到 async 函 数 的 执行 结果 时 才 调 用 await ( ) 方 法 进行 获取 , 这 样 两 个 async 国 数 就 变 成 一 种 并 
行 关 系 了 。 重 新 运行 程序 ,结果 如 图 11.18 所 示 。 


Run: ,app ~ com.example.retrofittest.CoroutinesTest... 


p "/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
result is 20, 
cost 1029 milliseconds. 


之 | Process finished with exit code 0 


图 11.18 async 函数 并 行 运行 耗 时 
可 以 看 到 ， 现 在 整 段 代码 的 运行 耗 时 变 成 了 1029 毫 秒 ， 运行 效率 的 提升 显而易见 。 
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最 后 ， 我们 再 来 学 习 一 个 比较 特殊 的 作用 域 构建 器 : withContext () 上 函数 。withContext( ) 
函数 是 一 个 挂 起 函数 ,大体 可 以 将 它 理解 成 async 函 数 的 一 种 简化 版 写法 ， 示 例 写法 如 下 : 


fun main() { 
runBlocking { 
val result = withContext(Dispatchers.Default) { 
5 + 5 


} 
println(result) 


} 


我 来 解释 一 下 这 段 代 码 。 调 用 withContext ( ) 函 数 之 后 ， 会 立即 执行 代码 块 中 的 代码 ， 同 时 将 
外 部 协 程 挂 起 。 当 代码 块 中 的 代码 全 部 执行 完 之 后 ， 会 将 最 后 一 行 的 执行 结果 作为 
withContext () 函 数 的 返回 值 返回 ， 因 此 基本 上 相当 于 vatl result = async{ 5 + 5 
}.await ( ) 的 写法 。 唯 一 不 同 的 是 ,withContext ( ) 函数 强制 要 求 我 们 指定 一 个 线程 参数 ， 
关于 这 个 参数 我 准备 好 好 讲 一 讲 。 


你 已 经 知道 ， 协 程 是 一 种 轻 量 级 的 线程 的 概念 ， 因 此 很 多 传统 编程 情况 下 需要 开局 多 线程 执行 
的 并 发 任务 ， 现 在 只 需要 在 一 个 线程 下 开启 多 个 协 程 来 执行 就 可 以 了 。 但 是 这 并 不 意味 着 我 们 
就 永远 不 需要 开启 线程 了 ， 比 如 说 Android 中 要 求 网 络 请 求 必须 在 子 线程 中 进行 ， 即 使 你 开启 了 
协 程 去 执行 网 络 请 求 ， 假 如 它 是 主线 程 当中 的 协 程 ， 那 么 程序 仍然 会 出 错 。 这 个 时 候 我 们 就 应 
该 通过 线程 参数 给 协 程 指定 一 个 具体 的 运行 线程 。 


线程 参数 主要 有 以 下 3 种 值 可 选 : Dispatchers .DefauLt、Dispatchers.I0 和 
Dispatchers .Main。Dispatchers .Default 表 示 会 使 用 一 种 默认 低 并 发 的 线程 策略 ， 当 
你 要 执行 的 代码 属于 计算 密集 型 任务 时 ， 开启 过 高 的 并 发 反而 可 能 会 影响 任务 的 运行 效率 ,此 
时 就 可 以 使 用 Dispatchers .Default。Dispatchers .I0 表 示 会 使 用 一 种 较 高 并 发 的 线程 策 
略 ， 当 你 要 执行 的 代码 大 多 数 时 间 是 在 阻塞 和 等 待 中 ， 比 如 说 执行 网 络 请 求 时 ， 为 了 能 够 支持 
更 高 的 并 发 数量 ， 此 时 就 可 以 使 用 Dispatchers.I0。Dispatchers.Main 则 表示 不 会 开启 
子 线程 ， 而 是 在 Android 主 线程 中 执行 代码 ， 但 是 这 个 值 只 能 在 Android 项 目 中 使 用 ， 纯 Kotlin 
程序 使 用 这 种 类 型 的 线程 参数 会 出 现 错误 。 


事实 上 ， 在 我 们 刚才 所 学 的 协 程 作用 域 构建 器 中 ， 除了 coroutineScope 函 数 之 外 ， 其 他 所 有 
的 函数 都 是 可 以 指定 这 样 一 个 线程 参数 的 ， 只 不 过 withContext ( ) 函数 是 强制 要 求 指定 的 ， 而 
其 他 函数 则 是 可 选 的 。 


到 目前 为 止 ， 你 已 经 掌握 了 协 程 中 最 常用 的 一 些 用 法 ， 并 且 了 解 了 协 程 的 主要 用 途 就 是 可 以 大 
幅度 地 提升 并 发 编程 的 运行 效率 。 但 实际 上 ，Kotlin 中 的 协 程 还 可 以 对 传统 回调 的 写法 进行 优 
化 ， 从 而 让 代码 变 得 更 加 简洁 ， 那 么 接 下 来 我 们 就 开始 学 习 这 部 分 的 内 容 。 


11.7.3 ”使 用 协 程 简化 回调 的 写法 
在 11.5 节 ， 我 们 学 习 了 编程 语言 的 回调 机 制 ， 并 使 用 这 个 机 制 实现 了 获取 异步 网 络 请 求 数据 咱 


应 的 功能 。 不 知道 你 有 没有 发 现 ， 回 调 机 制 基本 上 是 依靠 匿名 类 来 实现 的 ， 但 是 匿名 类 的 写法 
通常 比较 烦琐 ， 比 如 如 下 代码 : 
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HttpUtil.sendHttpRequest(address, object : HttpCallbackListener { 
override fun onFinish(response: String) { 
// 得 到 服务 器 返回 的 具体 内 容 
} 


override fun onError(e: Exception) { 
// 在 这 里 对 异常 情况 进行 处 理 
} 
}) 


在 多 少 个 地 方 发 起 网 络 请 求 ， 就 需要 编写 多 少 次 这 样 的 匿名 类 实现 。 这 不 禁 引 起 了 我 们 的 思 
考 ， 有 没有 更 加 简单 一 点 的 写法 呢 ? 


在 过 去 ， 可 能 确实 没有 什么 更 加 简单 的 写法 了 。 不 过 现在 ，Kotlin 的 协 程 使 我 们 的 这 种 设想 成 为 
了 9 可能， 只 需要 借助 suspendCoroutine 也 数 就 能 将 传统 回调 机 制 的 写法 大 幅 简 化 ， 下面 我 们 
就 来 具体 学 习 一 下 。 


suspendCoroutine 函 数 必 须 在 协 程 作 用 域 或 挂 起 函数 中 才能 调用 , 它 接 收 一 个 Lambda 表 达 
式 参数 ， 主 要 作用 是 将 当前 协 程 立 即 挂 起 ， 然 后 在 一 个 普通 的 线程 中 执行 Lambda 表 达 式 中 的 
代码 。Lambda 表 达 式 的 参数 列表 上 会 传 入 一 个 Continuation 参 数 , 调用 它 的 resume ( ) 方 
法 或 resumeWithException() 可 以 让 协 程 恢复 执行 。 


了 解 了 SuspendCoroutine 因 数 的 作用 之 后 ， 接 下 来 我 们 就 可 以 借助 这 个 函数 来 对 传统 的 回调 
写法 进行 优化 。 首 先 定义 一 个 request ( ) 函数 ， 代 码 如 下 所 示 : 


suspend fun request(address: String): String { 
return suspendCoroutine { continuation -> 
HttpUtil.sendHttpRequest(address, object : HttpCallbackListener { 
override fun onFinish(response: String) { 
continuation.resume(response) 


} 


override fun onError(e: Exception) { 
continuation.resumeWithException(e) 


}) 
} 


} 


可 以 看 到 ，request ( ) 函数 是 一 个 挂 起 函数 ， 并 且 接 收 一 个 add ress 参 数 。 在 request ( ) 国 
数 的 内 部 ， 我 们 调用 了 刚刚 介绍 的 suspendCoroutine 函 数 , 这 样 当前 协 程 就 会 被 立刻 挂 起 ， 
而 Lambda 表 达 式 中 的 代码 则 会 在 普通 线程 中 执行 。 接 着 我 们 在 Lambda 表 达 式 中 调用 
HttpUtil.sendHttpRequest() 方 法 发 起 网 络 请 求 ， 并 通过 传统 回调 的 方式 监听 请 求 结 果 。 
如 果 请 求 成 功 就 调用 Continuation 的 resume ( ) 方 法 恢复 被 挂 起 的 协 程 ， 并 传 入 服务 器 响应 
的 数据 ,该 值 会 成 为 SuspendCo routine 函 数 的 返回 值 。 如 果 请 求 失败 ， 就 调用 
Continuation 的 resumeWithException() 恢 复 被 挂 起 的 协 程 ， 并 传 入 具体 的 异常 原因 。 


你 可 能 会 说 ， 这 里 不 是 仍然 使 用 了 传统 回调 的 写法 吗 ? 代码 怎么 就 变 得 更 加 简化 了 ? 这 是 因 
为 ， 不 管 之 后 我 们 要 发 起 多 少 次 网 络 请 求 ， 都 不 需要 再 重复 进行 回调 实现 了 。 比 如 说 获取 百度 
首页 的 响应 数据 ， 就 可 以 这 样 写 : 
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suspend fun getBaiduResponse() { 
try { 
val response = request("https://www.baidu.com/") 
// 对 服务 器 响应 的 数据 进行 处 理 
} catch (e: Exception) { 
// 对 异常 情况 进行 处 理 


} 


} 


怎么 样 ， 有 没有 党 得 代码 变 得 清 囊 了 很 多 呢 ? 由 于 getBaiduResponse( ) 是 一 个 挂 起 函数 ， 

因此 当 它 调用 了 request ( ) 函数 时 ， 当 前 的 协 程 就 会 被 立刻 挂 起 ， 然 后 一 直 等 待 网 络 请 求 成 功 
或 失败 后 ， 当 前 协 程 才能 恢复 运行 。 这 样 即使 不 使 用 回调 的 写法 ， 我 们 也 能 够 获得 异步 网 络 请 
求 的 响应 数据 ， 而 如 果 请 求 失败 ， 则 会 直接 进入 catch 语 名 当中。 


不 过 这 里 你 可 能 又 会 产生 新 的 疑惑 ，getBaiduResponse( ) 函 数 被 声明 成 了 挂 起 函数 , 这 样 它 
也 只 能 在 协 程 作用 域 或 其 他 挂 起 函数 中 调用 了 ， 使 用 起 来 是 不 是 非常 有 局 限 性 ? 确实 如 此 ， 
为 SuspendCoroutine 函 数 本 身 就 是 要 结合 协 程 一 起 使 用 的 。 不 过 通过 合理 的 项 目 架 构 设 计 ， 
我 们 可 以 轻松 地 将 各 种 协 程 的 代码 应 用 到 一 个 普通 的 项 目 当 中 ， 在 第 15 章 的 项 目 实战 环节 你 将 


会 学 到 这 部 分 知识 。 


事实 上 ,suspendCoroutine 函 数 几乎 可 以 用 于 简化 任何 回调 的 写法 ， 比 如 之 前 使 用 Retrofit 
来 发 起 网 络 请 求 需要 这 样 写 : 


val appService = ServiceCreator.create<AppService>() 
appService.getAppData().enqueue(object : Callback<List<App>> { 
override fun onResponse(call: Call<List<App>>, response: Response<List<App>>) { 
// 得 到 服务 器 返回 的 数据 
} 


override fun onFailure(call: Call<List<App>>, t: Throwable) { 
// 在 这 里 对 异常 情况 进行 处 理 
} 
}) 


有 没有 觉得 这 里 回调 的 写法 也 是 相当 烦琐 的 ? 不 用 担心 ，, 使 用 suspendCoroutine 拯 数 , 我们 
马上 就 能 对 上 述 写 法 进行 大 幅度 的 简化 。 


由 于 不 同 的 service 接口 返回 的 数据 类 型 也 不 同 ， 所 以 这 次 我 们 不 能 像 刚 才 那 样 针 对 具体 的 类 
型 进行 编程 了 ， 而 是 要 使 用 泛 型 的 方式 。 定 义 一 个 await ( ) 范 数 ， 代 码 如 下 所 示 : 


suspend fun <T> Call<T>.await(): T { 
return suspendCoroutine { continuation -> 
enqueue(object : Callback<T> { 
override fun onResponse(call: Call<T>, response: Response<T>) { 

val body = response.body () 

if (body != null) continuation.resume(body) 

else continuation.resumeWithException( 

RuntimeException("response body is null")) 


} 


override fun onFailure(call: Call<T>, t: Throwable) { 
continuation.resumeWithException(t) 
} 


}) 
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} 
} 


这 段 代码 相 比 于 刚才 的 request ( ) 函 数 又 复杂 了 一 点 。 首 先 await ( ) 函数 仍然 是 一 个 挂 起 函 
数 ， 然 后 我 们 给 它 声明 了 一 个 泛 型 T, 并 将 await () 函 数 定义 成 了 CaLL<T> 的 扩展 函数 ,这样 
所 有 返回 值 是 Catl 1 类 型 的 Retrofit 网 络 请 求 接口 就 都 可 以 直接 调用 await ( ) 哨 数 了 。 


接着 ，await ( ) 范 数 中 使 用 了 suspendCoroutine 函 数 来 挂 起 当前 协 程 ， 并 且 由 于 扩展 函数 的 
原因 ， 我 们 现在 拥有 了 CatLL 对 象 的 上 下 文 ， 那 么 这 里 就 可 以 直接 调用 enqueue ( ) 方 法 让 
Retrofit 发 起 网 络 请 求 。 接 下 来 ， 使 用 同样 的 方式 对 Retrofit 向 应 的 数据 或 者 网 络 请 求 失败 的 情 
况 进 行 处 理 就 可 以 了 。 另 外 还 有 一 点 需要 注意 ,在 onResponse() 回 调 当 中 ,我 们 调用 body ( ) 
方法 解析 出 来 的 对 象 是 可 能 为 空 的 。 如 果 为 空 的 话 ,这 里 的 做 法 是 手动 抛 出 一 个 异常 ， 你 也 可 
以 根据 自己 的 逻辑 进行 更 加 合适 的 处 理 。 


有 了 await( ) 消 数 之 后 ,我 们 调用 所 有 Retrofit 的 Service 接 口 都 会 变 得 极其 简单 ， 比 如 刚才 
同样 的 功能 就 可 以 使 用 如 下 写法 进行 实现 : 


suspend fun getAppData() { 
try { 
val appList = ServiceCreator.create<AppService>().getAppData().await() 
// 对 服务 器 响应 的 数据 进行 处 理 
} catch (e: Exception) { 
// 对 异常 情况 进行 处 理 


} 


} 


没有 了 元 长 的 匿名 类 实现 ,只 需要 简单 调用 一 下 await ( ) 函数 就 可 以 让 Retrofit 发 起 网 络 请 求 ， 
并 直接 获得 服务 器 响应 的 数据 ， 有 没有 觉得 代码 变 得 极其 简单 ? 当然 你 可 能 会 觉得 ， 每 次 发 起 
网 络 请 求 都 要 进行 一 次 try catch 处 理 也 比较 麻烦 ， 其 实 这 里 我 们 也 可 以 选择 不 处 理 。 在 不 处 理 
的 情况 下 ， 如 果 发 生 了 异常 就 会 一 层 层 向 上 抛 出 ， 一 直到 被 某 一 层 的 函数 处 理 了 为 止 。 因 此 ， 
我 们 也 可 以 在 某 个 统一 的 入 口 函 数 中 只 进行 一 次 try catch， 从 而 让 代码 变 得 更 加 精简 。 


关于 Kotlin 的 协 程 ， 你 已 经 掌握 了 足够 多 的 理论 知识 ， 下 一 步 就 是 将 它 应 用 到 实际 的 Android 项 


目 当中 了 。 不 用 着 急 ， 我 们 将 会 在 第 15 章 中 学 习 这 部 分 内 容 ， 现 在 先 回顾 一 下 本 章 所 学 的 所 有 
知识 吧 。 
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11.8 ”小结 与 反 评 


本 章 中 我 们 主要 学 习 了 在 Android 中 使 用 HTTP 来 进行 网 络 交 互 的 知识 ， 虽 然 Android 中 支持 的 
网 络 通信 协议 有 很 多 种 ， 但 HTTP 无 疑 是 最 常用 的 一 种 。 通 常 我 们 有 两 种 方式 来 发 送 HTTP 请 
求 , 分别 是 HttpURLConnection 和 OkHttp ,相信 这 两 种 方式 你 都 已 经 很 好 地 掌握 了 。 


接着 我 们 又 学 习 了 XML 和 JSON 格 式 数 据 的 解析 方式 ， 因 为 服务 器 响应 给 我 们 的 数据 基本 属于 这 
两 种 格式 。 无 论 是 XML 还 是 JSON ,它们 各 自 又 拥有 多 种 解析 方式 ， 这 里 我 们 学 习 了 最 常用 的 几 
种 ， 相 信 已 经 足够 应 对 你 日 常 的 工作 需求 了 。 


之 后 我 们 又 学 习 了 编程 语言 的 回调 机 制 以 及 Retrofit 的 用 法 ， 其 中 Retrofit 已 经 几乎 成 为 了 所 有 
Android 项 目 首选 的 网 络 库 ， 使 用 率 非 常 高 ， 你 一 定 要 牢 牢 掌握 它 的 用 法 。 

在 本 章 的 Kotlin 课 堂 中 ， 我们 学 习 了 一 项 非常 特殊 的 技术 : 协 程 。 或 许 你 在 之 前 并 没有 听 说 过 这 
个 概念 ， 或 者 不 清楚 协 程 的 具体 作用 是 什么 ， 那 么 通过 本 节 课 的 学 习 ， 相 信 你 对 协 程 已 经 能 有 
一 个 比较 全 面 的 了 解 了 。 


关于 Android 网 络 编程 部 分 的 内 容 就 讲 到 这 里 ， 下 一 章 我 们 将 学 习 一 项 能 让 应 用 界面 变 得 更 加 好 
看 的 技术 一 一 Material Design。 
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第 12 章 最 佳 的 UI 体 验 ,Material 
Design 实 战 


其 实 长 久 以 来 ， 大 多 数 人 可 能 会 认为 Android 系 统 的 UI 并 不 算 美 观 ， 至 少 没有 iOS 系 统 的 美观 。 
以 至 于 很 多 盯 公 司 在 进行 应 用 界面 设计 的 时 候 ,为 了 保证 双 平 台 的 统一 性 ， 强 制 要求 Android 端 
的 界面 风格 必须 和 iOS 端 一 致 。 这 种 情况 在 现实 工作 当中 实在 是 太 常见 了 ， 虽 然 我 认为 这 是 非常 
不 合理 的 。 因 为 对 于 一 般 用 户 来 说 ， 他 们 不 太 可 能 会 在 两 个 操作 系统 上 分 别 使 用 同一 个 应 用 ， 
但 是 必定 会 在 同一 个 操作 系统 上 使 用 不 同 的 应 用 。 因 此 ， 同 一 个 操作 系统 中 各 个 应 用 之 间 的 界 
面 统一 性 要 远 比 一 个 应 用 在 双 平 台 的 界面 统一 性 重要 得 多 。 

但 是 Android 标 准 的 界面 设计 风格 并 不 是 特别 被 大 众 所 接 受 ， 很 多 公司 觉得 自己 可 以 设计 出 更 加 
好 看 的 界面 ， 从 而 寻 致 Android 平 台 的 界面 风格 长 期 难以 得 到 统一 。 为 了 解决 这 个 问题 ， 


Google 也 是 使 出 了 杀手 铀 ， 在 2014 年 Google IO 大 会 上 重 磅 推出 了 一 套 全 新 的 界面 设计 语言 
一 一 Material Design。 


本 章 我 们 就 将 对 Material Design 进 行 一 次 深入 的 学 习 。 
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12.1 什么 是 Material Design 


Material Design 是 由 Google 的 设计 工程 师 们 基于 传统 优秀 的 设计 原则 ,结合 丰富 的 创意 和 科 
学 技术 所 开发 的 一 套 全 新 的 界面 设计 语言 ,包含 了 视觉 、 运 动 、 互 动 效 果 等 特性 。 那 么 Google 
赁 什么 认为 Material Design 就 能 解决 Android 平 台 界 面 风格 不 统一 的 问题 呢 ? 一 言 以 英之 ， 好 
看 ! 


为 了 做 出 表率 ， Google 从 Android 5.0 系 统 开 始 ， 就 将 所 有 内 置 的 应 用 都 使 用 Material 
Design 风 格 进 行 设 计 。 图 12.1 是 我 截取 的 两 张 图 ， 你 可 以 先 欣赏 一 下 。 
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图 12.1 使 用 Material Design 设 计 的 应 用 


其 中 ,左边 的 应 用 是 Play Store , 右边 的 应 用 是 YouTube。 可 以 看 出 ， 它 们 的 界面 都 十 分 美 
观 ， 而 它们 都 是 使 用 Material Design 进 行 设计 的 。 


不 过 ,在 重 磅 推出 之 后 ,Material Design 的 普及 程度 却 不 是 特别 理想 。 因 为 这 只 是 一 个 推荐 的 
设计 规范 , 主要 是 面向 UI 设计 人 员 的 ,而 不 是 面向 开发 者 的 。 很 多 开发 者 可 能 根本 就 搞 不 清楚 
什么 样 的 界面 和 效果 才 叫 Material Design ， 就 算 搞 清楚 了 ， 实现 起 来 也 会 很 费劲 ， 因 为 不 少 
Material Design 的 效果 是 很 难 实现 的 ， 而 Android 中 几乎 没有 提供 相应 的 API 支 持 ， 基本 需要 
靠 开 发 者 自己 从 零 写 起 。 


Google 当 然 意识 到 了 这 个 问题 ， 于 是 在 2015 年 的 Google I/O 大 会 上 推出 了 一 个 Design 
Support 库 ,这 个 库 将 Material Design 中 最 具 代 表 性 的 一 些 控件 和 效果 进行 了 封装 ， 使 得 开发 
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者 即使 在 不 了 解 Material Design 的 情况 下 ,也 能 非常 轻松 地 将 自己 的 应 用 Material 化 。 后 来 
Design Support 库 又 改名 成 了 Material 库 ， 用 于 给 Google 全 平台 类 的 产品 提供 Material 
Design 的 支持 。 本 章 我 们 就 将 对 Material 库 进行 深入 的 学 习 ， 并 且 配 合 AndroidX 库 中 的 一 些 
空 件 来 完成 一 个 优秀 的 Material Design 应 用 。 


新 建 一 个 MaterialTest 项 目 ， 然 后 我 们 马上 开始 吧 ! 
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12.2 Toolbar 


Toolbar 将 会 是 我 们 本 章 接触 的 第 一 个 控件 ， 是 由 AndroidX 库 提供 的 。 虽 说 对 于 Toolbar 你 暂时 
应 该 还 是 比较 陌生 的 ， 但 是 对 于 它 的 另 一 个 相关 控件 ActionBar， 你 就 应 该 有 点 熟悉 了 。 


回忆 一 下 ,我 们 曾经 在 4.4.1 小 节 为 了 使 用 一 个 自 定义 的 标题 栏 , 而 隐藏 了 系统 原生 的 
ActionBar。 没 错 ， 每 个 Activity 最 顶部 的 那个 标题 栏 其 实 就 是 ActionBar , 之 前 我 们 编写 的 所 
有 程序 里 一 直 都 有 它 的 身影 。 


不 过 ActionBar 由 于 其 设计 的 原因 ， 被 限定 只 能 位 于 Activity 的 顶部 ， 从 而 不 能 实现 一 些 
Material Design 的 效果 ， 因 此 官方 现在 已 经 不 再 建议 使 用 ActionBar 了 。 那 么 本 书 中 我 也 就 不 
准备 再 介绍 ActionBar 的 用 法 了 ， 而 是 直接 讲解 现在 更 加 推荐 使 用 的 Toolbar。 


Toolbar 的 强大 之 处 在 于 , 它 不 仅 继承 了 ActionBar 的 所 有 功能 ,而 且 灵 活性 很 高 ,可 以 配合 其 
他 控件 完成 一 些 Material Design 的 效果 ， 下 面 我 们 就 来 具体 学 习 一 下 。 


首先 你 要 知道 ， 任 何 一 个 新 建 的 项 目 ， 上 默认 都 是 会 显示 ActionBar 的 ， 这 个 想必 你 已 经 见识 过 太 
多 次 了 。 那 么 这 个 ActionBar 到 底 是 从 哪里 来 的 呢 ? 其 实 这 是 根据 项 目 中 指定 的 主题 来 显示 的 。 
打开 AndroidManifest.xm| 文 件 看 一 下 ， 如 下 所 示 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 


可 以 看 到 ， 这 里 使 用 android:theme 属 性 指定 了 一 个 AppTheme 的 主题 。 那 么 这 个 
AppTheme 又 是 在 哪里 定义 的 呢 ?打开 res/values/styles.xm| 文 件 ， 代码 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


</resources> 


这 里 定义 了 一 个 叫 AppTheme 的 主题 ， 然 后 指定 它 的 parent 主 题 是 
Theme.AppCompat.Light. DarkActionBar。 这 个 DarkActionBar 是 一 个 深 色 的 ActionBar 
主题 ， 我 们 之 前 所 有 的 项 目 中 自 带 的 ActionBar 就 是 因为 指定 了 这 个 主题 才 出 现 的 。 
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而 现在 我 们 准备 使 用 Toolbar 来 蔡 代 ActionBar，, 因此 需要 指定 一 个 不 带 ActionBar 的 主题 ， 通 
常 有 Theme.AppCompat.NoActionBar 和 Theme.AppCompat.Light.NoActionBar 这 两 种 
主题 可 选 。 其 中 Theme.AppCompat.NoActionBar 表 示 深 色 主题 ， 它 会 将 界面 的 主体 颜色 设 
成 深 色 ， 陪衬 颜色 设 成 浅 色 。 而 Theme.AppCompat.Light.NoActionBar 表 示 浅 色 主 题 , 它 

会 将 界面 的 主体 颜色 设 成 浅 色 ， 陪衬 颜色 设 成 深 色 。 具 体 的 效果 你 可 以 自己 动手 试 一 试 ， 这 里 

由 于 我 们 之 前 的 程序 一 直 都 是 以 浅 色 为 主 的 ， 那么 我 就 选用 浅 色 主题 了 ， 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


</resources> 


观察 一 下 AppTheme 中 的 属性 重 写 ， 这 里 重 写 了 colorPrimary、colorPrimaryDark 和 
coLorAccent 这 3 个 属性 的 颜色 。 那 么 这 3 个 属性 分 别 代表 什么 位 置 的 颜色 呢 ? 我 用 语言 比较 难 
描述 清楚 ， 还 是 通过 一 张 图 来 理解 一 下 吧 , 如 图 12.2 所 示 。 


www.blogss.cn 


8:33 


MaterialTest 


colorPrimary 


textColorPrimary 


colorPrimaryDark 
windowBackground 


navigationBarColor 


colorAccent 


图 12.2 各 属性 指定 颜色 的 位 置 
可 以 看 到 ,每 个 属性 所 指定 颜色 的 位 置 直接 一 目 了 然 了 。 


除了 上 述 3 个 属性 之 外 , 我们 还 可 以 通过 textCotLtorPrimary、windowBackground 和 
navigationBarColor 等 属性 控制 更 多 位 置 的 颜色 。 不 过 唯 独 colLorAccent 这 个 属性 比较 难 
理解 ， 它 不 只 是 用 来 指定 这 样 一 个 按钮 的 颜色 , 而 是 更 多 表达 了 一 种 强调 的 意思 ，, 比如 一 些 控 
件 的 选中 状态 也 会 使 用 coLo rAccent 的 颜色 。 


现在 我 们 已 经 将 ActionBar 隐 藏 起 来 了 ， 那么 接 下 来 看 一 看 如 何 使 用 Toolbar 来 替代 
ActionBar。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 
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<androidx.appcompat.widget.TooLbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</FrameLayout> 


虽然 这 段 代 码 不 长 ， 但 是 里 面 着 实 有 不 少 技术 点 是 需要 我 们 仔细 琢磨 一 下 的 。 首 先 看 一 下 第 2 
行 ， 这 里 使 用 xmLns :app 指 定 了 一 个 新 的 命名 空间 。 思 考 一 下 ， 正 是 由 于 每 个 布局 文件 都 会 使 
用 xmtLns:android 来 指定 一 个 命名 空间 ,我 们 才能 一 直 使 用 android:id、android : 
Layout width 等 写法 。 这 里 指定 了 xmLns:app , 也 就 是 说 现在 可 以 使 用 app :attribute 这 
样 的 写法 了 。 但 是 为 什么 这 里 要 指定 一 个 xmLns :app 的 命名 空间 呢 ? 这 是 由 于 许多 Material 属 
性 是 在 新 系统 中 新 增 的 ， 老 系统 中 并 不 存在 ， 那 么 为 了 能 够 兼容 老 系统 ， 我 们 就 不 能 使 用 
android:attribute 这 样 的 写法 了 ， 而 是 应 该 使 用 app: attribute。 


接 下 来 定义 了 一 个 Toolbar 控 件 ,这 个 控件 是 由 appcompat 库 提供 的 。 这 里 我 们 给 Toolbar 指 定 
了 一 个 id ,将 它 的 宽度 设置 为 natch_parent， 高 度 设置 为 actionBar 的 高 度 ， 背 景色 设置 为 
colorPrimary。 不 过 下 面 的 部 分 就 稍微 有 点 难 理解 了 ,由 于 我 们 刚才 在 styles.xml 中 将 程序 的 
主题 指定 成 了 浅 色 主 题 ， 因 此 Toolbar 现 在 也 是 浅 色 主题 ， 那么 Toolbar 上 面 的 各 种 元 素 就 会 自 
动 使 用 深 色 系 ， 从 而 和 主体 颜色 区 别 开 。 但 是 之 前 使 用 ActionBar 时 文字 都 是 白色 的 ， 现 在 变 成 
黑色 的 会 很 难看 。 那 么 为 了 能 让 Toolbar 单 独 使 用 深 色 主题 ， 这 里 我 们 使 用 了 android :theme 
属性 , 将 Toolbar 的 主题 指定 成 了 ThemeOverlay.AppCompat.Dark.ActionBar。 但 是 这 样 指 
定之 后 又 会 出 现 新 的 问题 ， 如果 Toolbar 中 有 菜单 按钮 (我 们 在 3.2.5 小 节 中 学 过 ) ， 那 么 弹出 
的 菜单 项 也 会 变 成 深 色 主 题 ， 这 样 就 再 次 变 得 十 分 难看 了 ， 于 是 这 里 又 使 用 了 
app:popupTheme 属 性 ,单独 将 弹出 的 菜单 项 指定 成 了 浅 色 主题 。 


如 果 你 觉得 上 面 的 描述 很 绕 的 话 ， 可 以 自己 动手 做 一 做 实验 ， 看 看 不 指定 上 述 主题 会 是 什么 样 
的 效果 ， 这 样 你 会 理解 得 更 加 深刻 。 
写 完 了 布局 ， 接 下 来 我 们 修改 MainActivity， 代 码 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
setSupportActionBar (toolbar) 


} 


这 里 关键 的 代码 只 有 一 句 ， 调 用 setSupportActionBar() 方 法 并 将 Toolbar 的 实例 传 入 , 这 
样 我 们 就 做 到 既 使 用 了 Toolbar , 又 让 它 的 外 观 与 功能 都 和 ActionBar 一 致 了 。 


现在 运行 一 下 程序 ,效果 如 图 12.3 所 示 。 
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MaterialTest 


图 12.3 Toolbar 的 标准 界面 


这 个 标题 栏 我 们 再 熟悉 不 过 了 ， 虽然 看 上 去 和 之 前 的 标题 栏 没 什么 两 样 ， 但 其 实 它 已 经 是 
Toolbar 而 不 是 ActionBar 了 。 因 此 它 现在 也 具备 了 实现 Material Design 效 果 的 能 力 ， 这 个 我 
们 在 后 面 就 会 学 到 。 


接 下 来 我 们 再 学 习 一 些 Toolbar 比 较 常 用 的 功能 吧 ,比如 修改 标题 栏 上 显示 的 文字 内 容 。 这 段 文 
字 内 容 是 在 AndroidManifest.xmlI 中 指定 的 ， 如 下 所 示 : 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
<activity 
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android:name=" .MainActiVvity” 
android:label="Fruits"> 


</activity> 
</application> 


这 里 给 activity 增 加 了 一 个 android:LabeL 属 性 ， 用 于 指定 在 Toolbar 中 显示 的 文字 内 容 ， 
如 果 没 有 指定 的 话 ， 会 默认 使 用 application 中 指定 的 Label 内 容 ， 也 就 是 我 们 的 应 用 名 称 。 


不 过 只 有 一 个 标题 的 T00lbar 看 起 来 太 单调 了 ， 我 们 还 可 以 再 添加 一 些 action 按 钮 来 让 Toolbar 
更 加 丰富 一 些 。 这 里 我 提前 准备 了 几 张 图 片 作为 按钮 的 图 标 ， 将 它们 放 在 了 drawable-xxhdpi 
目录 下 (资源 下 载 方 式 见 前 言 ) 。 现 在 右 击 res 目 录 刁 NewDirectory， 创建 一 个 menu 文 件 
夹 。 然 后 右 击 menu 文 件 夹 =New 一 Menu resource file， 创 建 一 个 toolbparxm| 文 件 ， 并 编写 
如 下 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto"> 
<item 
android:id="@+id/backup" 
android:icon="@drawable/ic backup" 
android:title="Backup" 
app:showAsAction="always" /> 
<item 
android:id="@+id/delete" 
android:icon="@drawable/ic delete" 
android:title="Delete" 
app:showAsAction="ifRoom" /> 
<item 
android:id="@+id/settings" 
android:icon="@drawable/ic settings" 
android:title="Settings" 
app:showAsAction="never" /> 
</menu> 


可 以 看 到 ， 我 们 通过 <item> 标 签 来 定义 action 按 钮 ，android :id 用 于 指定 按钮 的 id ， 
android:icon 用 于 指定 按钮 的 图 标 , android:titLe 用 于 指定 按钮 的 文字 。 


接着 使 用 app :showAsAction 来 指定 按钮 的 显示 位 置 , 这 里 之 所 以 再 次 使 用 了 app 命 名 空间 ， 
同样 是 为 了 能 够 兼容 低 版 本 的 系统 。showAsAction 主 要 有 以 下 几 种 值 可 选 : aLways 表 示 永 远 
显示 在 Toolbar 中 ， 如 果 屏 幕 空 间 不 够 则 不 显示 ; ifRoom 表 示 屏 幕 空间 足够 的 情况 下 显示 在 
Toolbar 中 ,不够 的 话 就 显示 在 菜单 当中 ; never 则 表示 永远 显示 在 菜单 当中 。 注 意 ，Toolbar 
中 的 action 按 钮 只 会 显示 图 标 ， 菜单 中 的 action 按 钮 只 会 显示 文字 。 


接 下 来 的 做 法 就 和 3.2.5 小 节 中 的 完全 一 致 了 ， 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreateOptionsMenu(menu: Menu?): Boolean { 
menuInflater.inflate(R.menu.toolbar, menu) 
return true 


} 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
when (item.itemId) { 
R.id.backup -> Toast.makeText(this, "You clicked Backup", 
Toast .LENGTH SHORT).show() 
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R.id.delete -> Toast.makeText(this, "You clicked Delete", 
Toast .LENGTH SHORT).show() 
R.id.settings -> Toast.makeText(this, "You clicked Settings", 
Toast .LENGTH SHORT) ,show() 


} 


return true 


} 


非常 简单 ， 我 们 在 onCreate0ptionsMenu () 方 法 中 加 载 了 toolbarxml 这 个 菜单 文件 ， 然 后 
在 on0ptionsItemSeLected ( ) 方 法 中 处 理 各 个 按钮 的 点 击 事件 。 现 在 重新 运行 一 下 程序 , 效 


果 如 图 12.4 所 示 。 


9:11 


Fruits 


图 12.4 带 有 action 按 钮 的 Toolbar 


可 以 看 到 ，Toolbar 上 现在 显示 了 两 个 action 按 钮 ， 这 是 因为 Backup 按 钮 指定 的 显示 位 置 是 
always ，Delete 按 钮 指定 的 显示 位 置 是 ifRoom ,而 现在 屏幕 空间 很 充足 ， 因 此 两 个 按钮 都 会 
显示 在 Toolbar 中 。 另 外 一 个 Settings 按 钮 由 于 指定 的 显示 位 置 是 never， 所 以 不 会 显示 在 
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Toolbar 中 , 点 击 一 下 最 右边 的 菜单 按钮 来 展开 菜单 项 ， 你 就 能 找到 Settings 按 钮 了 。 另 外 ,这 
些 action 按 钮 都 是 可 以 响应 点 击 事件 的 ,你 可 以 自己 去 试 一 试 。 


好 了 ， 关 于 Toolbar 的 内 容 就 先 讲 这 么 多 吧 。 当 然 Toolbar 的 功能 还 远 远 不 只 这 些 ， 不 过 我 们 显 
然 无 法 在 一 节 当 中 就 把 所 有 的 用 法 全 部 学 完 ， 后 面 会 结合 其 他 控件 来 挖掘 Toolbar 的 更 多 功能 。 


www.blogss.cn 


12.3 滑动 菜单 


滑动 菜单 可 以 说 是 Material Design 中 最 常见 的 效果 之 一 了 ， 许多 Google 自 家 的 应 用 (如 
Gmail、Google Photo 等 ) 具有 滑动 菜单 的 功能 。 虽 说 这 个 功能 看 上 去 好 像 挺 复杂 的 ， 不 过 借 
助 Google 提 供 的 各 种 工具 ,我们 可 以 很 轻松 地 实现 非常 炫 酷 的 滑动 菜单 效果 ， 那么 我 们 马上 开 
始 吧 。 


12.3.1 DrawerLayout 


所 谓 的 滑动 菜单 ， 就 是 将 一 些 菜单 选项 隐藏 起 来 ， 而 不 是 放置 在 主屏 幕 上 ， 然后 可 以 通过 滑动 
的 方式 将 菜单 显示 出 来 。 这 种 方式 既 节 省 了 屏幕 空间 ， 又 实现 了 非常 好 的 动画 效果 ,是 
Material Design 中 推荐 的 做 法 。 


不 过 ， 如果 我 们 全 靠 自己 去 实现 上 述 功 能 的 话 ， 难 度 恐 怕 就 很 大 了 。 幸 运 的 是 ,， Google 在 
AndroidX 库 中 提供 了 一 个 DrawerLayout 控 件 ， 借 助 这 个 控件 ， 实 现 滑动 菜单 简单 又 方便 。 


先 来 简单 介绍 一 下 DrawerLayout 的 用 法 吧 。 首 先 它 是 一 个 布局 ， 在 布局 中 人 允许 放 入 两 个 直接 
子 控件 : 第 一 个 子 控件 是 主屏 幕 中 显示 的 内 容 ， 第 二 个 子 控件 是 滑动 菜单 中 显示 的 内 容 。 
此 , 我 们 就 可 以 对 activity_main.xml 中 的 代码 做 如 下 修改 : 


<androidx.drawerlayout.widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<FrameLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</FrameLayout> 


<TextView 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout gravity="start" 
android:background="#FFF" 
android:text="This is menu" 
android:textSize="30sp" /> 


</androidx.drawerlayout.widget.DrawerLayout> 


可 以 看 到 ， 这 里 最 外 层 的 控件 使 用 了 DrawerLayout。DrawerLayout 中 放置 了 两 个 直接 子 控 
件 : 第 一 个 子 控件 是 Fr ameLayout , 用 于 作为 主屏 幕 中 显示 的 内 容 ， 当然 里 面 还 有 我 们 刚刚 定 
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义 的 Toolbar ; 第 二 个 子 控件 是 一 个 TextView， 用 于 作为 滑动 菜单 中 显示 的 内 容 ， 其 实 使 用 什 
么 都 可 以 ，DrawerLayout 并 没有 限制 只 能 使 用 固定 的 控件 。 


但 是 关于 第 二 个 子 控件 有 一 点 需要 注意 ,Layout_gravity 这 个 属性 是 必须 指定 的 ， 因 为 我 们 
需要 告诉 DrawerLayout 滑 动 菜单 是 在 屏幕 的 左边 还 是 右边 ， 指 定 left 表 示 滑 动 菜单 在 左边 ， 指 
定 right 表 示 滑 动 菜单 在 右边 。 这 里 我 指定 了 start ， 表 示 会 根据 系统 语言 进行 判断 ， 如 果 系 统 语 
言 是 从 左 往 右 的 ， 比 如 英语 、 汉 语 ， 滑动 菜 单 就 在 左边 ， 如 果 系 统 语言 是 从 右 往 左 的 ， 比 如 阿 
拉 伯 语 ， 滑动 菜单 就 在 右边 。 


没 错 ， 只 需要 改动 这 么 多 就 可 以 了 ， 现在 重新 运行 一 下 程序 ， 然 后 在 屏幕 的 左 侧 边 缘 向 右 拖 
动 ， 就 可 以 让 滑动 菜单 显示 出 来 了 ， 如 图 12.5 所 示 。 


This is menu 


图 12.5 显示 滑动 菜单 界面 


向 左 滑动 菜单 ， 或 者 点 击 一 下 菜单 以 外 的 区 域 ， 都 可 以 让 滑动 菜单 关闭 ， 从 而 回 到 主 界面 。 无 
论 是 展示 还 是 隐藏 滑动 菜单 ， 都 有 非常 流畅 的 动画 过 渡 。 

可 以 看 到 ， 我 们 只 是 稍微 改动 了 一 下 布局 文件 ， 就 能 实现 如 此 炫 酷 的 效果 ， 是 不 是 觉得 挺 激动 
呢 ? 不 过 现在 的 滑动 菜单 还 有 点 问题 ， 因 为 只 有 在 屏幕 的 左 侧 边缘 进行 拖 动 时 才能 将 菜单 拖 出 
来 ， 而 很 多 用 户 可 能 根本 就 不 知道 有 这 个 功能 ， 那 么 该 怎么 提示 他 们 呢 ? 
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Material Design 建 议 的 做 法 是 在 Toolbar 的 最 左边 加 入 一 个 导航 按钮 ， 点 击 按钮 也 会 将 滑动 菜 
单 的 内 容 展示 出 来 。 这 样 就 相当 于 给 用 户 提供 了 两 种 打开 滑动 菜单 的 方式 ， 防 止 一 些 用 户 不 知 
道 屏 幕 的 左 侧 边缘 是 可 以 拖 动 的 。 


下 面 我 们 来 实现 这 个 功能 。 首 先 我 准备 了 一 张 导航 按钮 的 图 标 ic_menu.png， 将 它 放 在 了 
drawable-xxhdpi 目 录 下 。 然 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
setSupportActionBar (toolbar) 
supportActionBar?.let { 
it.setDisplayHomeAsUpEnabled (true) 
it.setHomeAsUpIndicator(R.drawable.ic menu) 
} 
} 


override fun onOptionsItemSelected(item: MenuIltem): Boolean { 


when (item.itemId) { 
android.R.id.home -> drawerLayout.openDrawer(GravityCompat.START) 


} 


return true 


} 
这 里 我 们 并 没有 改动 多 少 代码 ， 首 先 调用 getSupportActionBar( ) 方 法 得 到 了 ActionBar 的 
实例 ,虽然 这 个 ActionBar 的 具体 实现 是 由 Toolbar 来 完成 的 。 接 着 在 ActionBar 不 为 空 的 情况 
下 调用 setDisplayHomeAsUpEnabled() 方 法 让 导航 按钮 显示 出 来 ， 调用 
setHomeAsUpIndicator() 方 法 来 设置 一 个 导航 按钮 图 标 。 实 际 上 ，Toolbar 最 左 侧 的 这 个 按 
钮 就 叫 作 Home 按 钮 ， 它 默认 的 图 标 是 一 个 返回 的 箭头 ， 含 义 是 返回 上 一 个 Activity。 很 明显 ， 
这 里 我 们 将 它 默 认 的 样式 和 作用 都 进行 了 修改 。 

接 下 来 ， 在 on0ptionsItemSeLected () 方 法 中 对 Home 按 钮 的 点 击 事件 进行 处 理 ，Home 按 
钮 的 id 永远 都 是 android.R,id.home。 然 后 调用 DrawerLayout 的 openDrawer( ) 方 法 将 滑 
动 菜单 展示 出 来 ， 注 意 ，openD rawer () 方 法 要 求 传 入 一 个 Gravity 参数 ， 为 了 保证 这 里 的 行 
为 和 XML 中 定义 的 一 致 ， 我 们 传 入 了 GravityCompat .START。 


现在 重新 运行 一 下 程序 , 效果 如 图 12.6 所 示 。 
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图 12.6 ”显示 Home 按 钮 


可 以 看 到 ， 在 Toolbar 的 最 左边 出 现 了 一 个 导航 按钮 ， 用 户 看 到 这 个 按钮 就 知道 它 肯定 是 可 以 点 
击 的 。 现 在 点 击 一 下 这 个 按钮 ， 滑 动 菜单 界面 就 会 再 次 展示 出 来 了 。 


12.3.2 NavigationView 
目前 我 们 已 经 成 功 实现 了 滑动 菜单 功能 ， 其 中 滑动 功能 已 经 做 得 非常 好 了 ,但 是 菜单 却 还 很 


丑 ， 毕 竞 菜单 页 面 仅仅 使 用 了 一 个 TextView ,非常 单调 。 有 对 比 才 会 有 落差 ， 我们 看 一 下 Play 
Store 的 滑动 菜单 页 面 是 长 什么 样 的 ， 如 图 12.7 所 示 。 
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图 12.7 Play Store 的 滑动 菜单 页 面 


经 过 对 比 ， 是 不 是 觉得 我 们 的 滑动 菜单 页 面 更 丑 了 ? 不 过 没关系 ， 优 化 滑动 菜单 页 面 ， 这 就 是 
我 们 本 小 节 的 全 部 目标 。 


事实 上 ， 你 可 以 在 滑动 菜单 页 面 定制 任意 的 布局 ,不 过 Google 给 我 们 提供 了 一 种 更 好 的 方法 
一 一 使 用 NavigationView。NavigationView 是 Material 库 中 提供 的 一 个 控件 ， 它 不 仅 是 严格 
按照 Material Design 的 要 求 来 设计 的 ， 而 且 可 以 将 滑动 菜单 页 面 的 实现 变 得 非常 简单 。 接 下 来 
我 们 就 学 习 一 下 NavigationView 的 用 法 。 


首先 ， 既然 这 个 控件 是 Material 库 中 提供 的 ， 那么 我们 就 需要 将 这 个 库 引 入 项 目 中 才 行 。 打 开 
app/build.gradle 文 件 ， 在 dependencies 闭 包 中 添加 如 下 内 容 : 


dependencies { 


implementation 'com.google.android.material:material:1.1.0' 
implementation 'de.hdodenhof:circleimageview:3.0.1' 


} 
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这 里 添加 了 两 行 依赖 关系 : 第 一 行 就 是 Material 库 ， 第 二 行 是 一 个 开源 项 目 
CirclelmageView , 它 可 以 用 来 轻松 实现 图 片 贺 形 化 的 功能 ， 我们 待 会 就 会 用 到 它 。 


需要 注意 的 是 ， 当 你 引入 了 Material 库 之 后 ， 还 需要 将 res/values/styles.xmI 文 件 中 
AppTheme 的 parent 主 题 改 成 Theme.MaterialComponents.Light.NoActionBar ， 


使 用 接 下 来 的 一 些 控件 时 可 能 会 遇 到 衣 溃 问题 。 


在 开始 使 用 NavigationView 之 前 ， 我 们 还 需要 准备 好 两 个 东西 : menu 和 headerLayout。 
menu 是 用 来 在 NavigationView 中 显示 具体 的 菜单 项 的 ,headerLayout 则 是 用 来 在 
NavigationView 中 显示 头 部 布局 的 。 


先 来 准备 menu。 这 里 我 事先 找 了 几 张 图 片 作 为 按钮 的 图 标 ， 并 将 它们 放 在 了 drawable- 
Xxxhdpi 目 录 下 。 右 击 menu 文 件 夹 >New 一 Menu resource file， 创 建 一 个 nav_menu.xm| 文 


件 ， 并 编写 如 下 代码 : 


否则 在 


<menu xmlns:android="http://schemas.android.com/apk/res/android"> 
<group android:checkableBehavior="single"> 
<item 


android 
android 
android 
<item 
android 
android 
android 
<item 
android 
android 
android 
<item 
android 
android 
android 
<item 
android 
android 


:id="@+id/navCall" 
:ijcon="@drawable/nav_ call" 
:title="Call" /> 


:id="@+id/navFriends" 
:icon="@drawable/nav friends" 
:title="Friends" 


/> 


:id="@+id/navLocation" 
:ijcon="@drawable/nav_ location" 
:title="Location" 


/> 


:id="@+id/navMail" 
:ijcon="@drawable/nav mail" 
:title="Mail" /> 


:id="@+id/navTask" 
:ijcon="@drawable/nav_ task" 


android:title="Tasks" /> 
</group> 


</menu> 


我 们 首先 在 <menu> 中 骨 套 了 一 个 <group> 标 签 ， 然 后 将 group 的 checkabLeBehavior 属 性 
指定 为 SingLe。group 表 示 一 个 组 ，checkabLeBehavior 指 定 为 singLe 表 示 组 中 的 所 有 菜 


单项 只 能 单 选 。 
下 面 我 们 来 看 一 下 这 些 菜单 项 吧 。 这 里 一 共 定 义 了 5 个 item , 分 别 使 用 android :id 属性 指定 菜 
2 android:icon 属 性 指定 菜单 项 的 图 标 , android:tittLe 属 性 指定 菜单 项 显示 的 


。 就 是 这 么 简单 ， 现 在 我 们 已 经 把 menu 准 备 好 了 。 


接 下 来 应 该 文 准备 headerLayout 了 ， 这 是 一 个 可 以 随意 定制 的 布局 ,不 过 我 并 不 想 将 它 做 得 太 复 
杂 。 这 里 简单 起 见 ， 我 们 就 在 headerLayout 中 放置 头像 、 用 户 名 、 邮 箱 地 址 这 3 项 内 容 吧 。 


这 里 我 找 了 一 张 宠物 图 片 ， 并 把 它 放 在 了 
我 们 会 把 它 圆 形 


说 到 头像 ， 那 我 们 还 需要 再 准备 一 张 图 片 ， 
drawable-xxhdpi 目 录 下 。 另 外 , 这 张 图 片 最 好 是 一 张 正 方形 图 片 ， 因 为 待 会 
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化 。 然 后 右 击 layout 文 件 夹 New 一 Layout resource file ,创建 一 个 nav_headerxm| 文 件 。 
修改 其 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="180dp" 
android:padding="10dp" 
android:background="@color/colorPrimary"> 


<de.hdodenhof .circleimageview.CircleImageView 
android:id="@+id/iconImage" 
android:Layout width="70dp" 
android:layout height="70dp" 
android:src="@drawable/nav_icon" 
android:layout centerInParent="true" /> 


<TextView 
android:id="@+id/mailText" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:text="tonygreendev@gmail.com" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


<TextView 

android:id="@+id/userText" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout above="@id/mailText" 
android:text="Tony Green" 
android:textColor="#FFF" 
android:textSize="14sp" /> 


</RelativeLayout> 


可 以 看 到 ， 布 局 文件 的 最 外 层 是 一 个 RelativeLayout , 我 们 将 它 的 宽度 设 为 natch_parent ， 
高 度 设 为 180 dp， 这 是 一 个 NavigationView 比 较 适 合 的 高 度 ， 然后 指定 它 的 背景 色 为 
colorPrimary, 


在 RelativeLayout 中 我 们 放置 了 3 个 控件 ,CirclelmageView 是 一 个 用 于 将 图 片 圆 形 化 的 控 
件 ， 它 的 用 法 非常 简单 ， 基 本 和 ImageView 是 完全 一 样 的 ,这 里 给 它 指定 了 一 张 图 片 作为 头 
像 ， 然 后 设置 为 居中 显示 。 另 外 两 个 TextView 分 别 用 于 显示 用 户 名 和 邮箱 地 址 ， 它们 都 用 到 了 
一 些 RelativeLayout 的 定位 属性 ,相信 肯定 难 不 倒 你 吧 ? 


现在 menu 和 headerLayout 都 准备 好 了 ，, 我们 终于 可 以 使 用 NavigationView 了 。 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<androidx.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<FrameLayout 
android:layout width="match parent" 
android:layout height="match parent"> 
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<androidx.appcompat.widget.TooLbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</FrameLayout> 


<com.google.android.material.navigation.NavigationView 
android:id="@+id/navView" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout gravity="start" 
app:menu="@menu/nav_menu" 
app:headerLayout="@layout/nav header"/> 


</androidx.drawerlayout.widget.DrawerLayout> 


可 以 看 到 , 我们 将 之 前 的 TextView 换 成 了 NavigationView , 这 样 滑动 菜单 中 显示 的 内 容 也 就 
变 成 NavigationView 了 。 这 里 又 通过 app :menu 和 app:headerLayout 属 性 将 我 们 刚才 准备 
好 的 menu 和 headerLayout 设 置 了 进去 ， 这样 NavigationView 就 定义 完成 了 。 


NavigationView 虽 然 定义 完成 了 ， 但 是 我 们 还 要 处 理 菜单 项 的 点 击 事件 才 行 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
setSupportActionBar(toolbar) 
supportActionBar?.let { 
it.setDisplayHomeAsUpEnabled (true) 
it.setHomeAsUpIndicator(R.drawable.ic menu) 
} 
navView.setCheckedItem(R.id.navCall) 
navView.setNavigationItemSelectedListener { 
drawerLayout.closeDrawers() 
true 


} 


代码 还 是 比较 简单 的 ， 这 里 我 们 首先 调用 了 NavigationView 的 setCheckedItem() 方 法 将 
Call 荣 单项 设置 为 默认 选中 。 接 着 调用 了 setNavigationItemSelectedListener() 方 法 
来 设置 一 个 菜单 项 选中 事件 的 监听 器 ， 当 用 户 点 击 了 任意 菜单 项 时 ， 就 会 回调 到 传 入 的 
Lambda 表 达 式 当中 ， 我 们 可 以 在 这 里 编写 具体 的 逻辑 处 理 。 这 里 调用 了 DrawerLayout 的 
closeDrawers( ) 方 法 将 滑动 菜单 关闭 ,并 返回 true 表 示 此 事件 已 被 处 理 。 


现在 可 以 重新 运行 一 下 程序 了 ， 点击 一 下 Toolbar 左 侧 的 导航 按钮 ， 效果 如 图 12.8 所 示 。 
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图 12.8 NavigationView 界 面 


怎么 样 ? 这 样 的 滑动 菜单 页 面 ， 你 无 论 如 何 也 不 能 说 尼 丑 了 吧 ? Material Design 的 魅力 就 在 于 
此 , 它 具 有 非常 美观 的 设计 理念 ， 只 要 你 按照 它 的 各 种 规范 和 建议 来 设计 界面 ， 最 终 做 出 来 的 
程序 就 是 特别 好 看 的 。 

相信 你 对 现在 做 出 来 的 效果 也 一 定 十 分 满意 吧 ? 不 过 不 要 满足 于 现状 ， 后 面 我 们 会 实现 更 加 炫 
酷 的 效果 。 跟 紧 脚 步 ， 继 续 学 习 吧 。 
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12.4 悬浮 按钮 和 可 交互 提示 


立 面 设计 是 Material Design 中 一 条 非常 重要 的 设计 思想 ， 也 就 是 说 ， 按 照 Material Design 的 
理念 ， 应 用 程序 的 界面 不 仅仅 是 一 个 平面 ,而 应 该 是 有 立体 效果 的 。 在 官方 给 出 的 示例 中 ,最 
简单 且 最 具 代表 性 的 立 面 设 计 就 是 悬浮 按钮 了 ， 这 种 按钮 不 属于 主 界面 平面 的 一 部 分 ,而 是 位 
于 另外 一 个 维度 的 ， 因 此 就 会 给 人 一 种 悬浮 的 感觉 。 


本 节 中 我 们 会 对 这 个 悬浮 按钮 的 效果 进行 学 习 ， 另 外 还 会 学 习 一 种 可 交互 式 的 提示 工具 。 关 于 
提示 工具 ， 我们 之 前 一 直 使 用 的 是 Toast , 但 是 Toast 只 能 用 于 告知 用 户 某 事 已 经 发 生 了 ， 用 户 
却 不 能 对 此 做 出 任何 的 响应 ， 那 么 今天 我 们 就 将 在 这 一 方面 进行 扩展 。 


12.4.1 FloatingActionButton 


FloatingActionButton 是 Material 库 中 提供 的 一 个 控件 ， 这 个 控件 可 以 帮助 我 们 比较 轻松 地 实 
现 悬 浮 按钮 的 效果 。 其 实在 之 前 的 图 12.2 中 ， 我 们 就 已 经 预览 过 悬浮 按钮 的 样子 了 ， 它 默认 会 
使 用 colorAccent 作 为 按钮 的 颜色 ， 我 们 还 可 以 通过 给 按钮 指定 一 个 图 标 来 表明 这 个 按钮 的 作用 
是 什么 。 


下 面 开 始 具 体 实现 。 首 先 仍然 需要 提前 准备 好 一 个 图 标 ， 这 里 我 放置 了 一 张 ic_done.png 到 
drawable-xxhdpi 目 录 下 。 然 后 修改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<androidx.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<FrameLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


<com.google.android.material.floatingactionbutton.FloatingActionButton 
android:id="@+id/fab" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout gravity="bottom|end" 
android:layout margin="16dp" 
android:src="@drawable/ic done" /> 


</FrameLayout> 


</androidx.drawerlayout .widget .DrawerLayout> 
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可 以 看 到 ， 这 里 我 们 在 主屏 幕布 局 中 加 入 了 一 个 FloatingActionButton。 这 个 控件 的 用 法 并 没 
有 什么 特别 的 地 方 ，layout width 和 Layout height 属 性 都 指定 成 wrap_content ， 
layout_gravity 属 性 指定 将 这 个 控件 放置 于 屏幕 的 右 下 角 。 其 中 end 的 工作 原理 和 之 前 的 
start 是 一 样 的 , 即 如 果 系 统 语言 是 从 左 往 右 的 ， 那 么 and 就 表示 在 右边 ， 如 果 系 统 语言 是 从 右 
往 左 的 ， 那 么 end 就 表示 在 左边 。 然 后 通过 Layout_margin 属 性 给 控件 的 四 周 留 点 边 距 ， 紧 贴 
着 屏幕 边缘 肯定 是 不 好 看 的 ， 最 后 通过 src 属 性 给 FloatingActionButton 设 置 了 一 个 图 标 。 


没 错 ， 就 是 这 么 简单 ， 现 在 我 们 就 可 以 运行 一 下 了 ， 效果 如 图 12.9 所 示 。 


Fruits 


图 12.9 悬浮 按钮 的 效果 
一 个 漂亮 的 悬浮 按钮 就 在 屏幕 的 右 下 方 出 现 了 。 


如 果 你 仔细 观察 的 话 ， 会 发 现 这 个 悬浮 按钮 的 下 面 还 有 一 点 阴影 。 其 实 这 很 好 理解 ， 因 为 
FloatingActionButton 是 悬浮 在 当前 界面 上 的 ， 既 然 是 悬浮 ， 那 么 理 所 应 当 会 有 投影 ， 
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Material 库 连 这 种 细节 都 帮 有 我 们 考虑 到 了 。 


说 到 悬浮 ， 其 实 我 们 还 可 以 指定 FloatingActionButton 的 悬浮 高 度 , 如 下 所 示 : 


<com.google.android.material.floatingactionbutton.FloatingActionButton 
android:id="@+id/fab" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout gravity="bottom|end" 
android:layout margin="16dp" 
android:src="@drawable/ic done" 
app:elevation="8dp" /> 


这 里 使 用 app :elevation 属 性 给 FloatingActionButton 指 定 一 个 高 度 值 。 高 度 值 越 大 ， 投影 
范围 也 越 大 ， 但 是 投影 效果 越 淡 ; 高 度 值 越 小 ， 投影 范围 也 越 小 ,但 是 投影 效果 越 浓 。 当 然 这 
些 效果 的 差异 其 实 并 不 怎么 明显 , 我 个 人 感觉 使 用 默认 的 FloatingActionButton 效 果 就 已 经 足 
够 了 。 


接 下 来 我 们 看 一 下 FloatingActionButton 是 如 何 处 理 点 击 事件 的 ， 毕竟， 一 个 按钮 首先 要 能 点 
击 才 有 意义 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


fab.setOnClickListener { 
Toast.makeText(this, "FAB clicked", Toast.LENGTH SHORT).show() 


} 


如 果 你 在 期 待 FloatingActionButton 会 有 什么 特殊 用 法 的 话 ， 那 可 能 要 让 你 失望 了 ， 它 和 普通 
的 Button 其 实 没什么 两 样 ， 都 是 调用 set0nClickListener() 方 法 来 设置 按钮 的 点 击 事件 ， 
这 里 我 们 只 是 弹出 了 一 个 Toast。 


现在 重新 运行 一 下 程序 ,并 点 击 “FloatingActionButton”, 效果 如 图 12.10 所 示 。 
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FAB clicked @ 


图 12.10 ”处 理 FloatingActionButton 的 点 击 事件 


12.4.2 Snackbar 


现在 我 们 已 经 掌握 了 FloatingActionButton 的 基本 用 法 ,不 过 在 上 一 小 节 处 理 点 击 事件 的 时 
候 ， 仍然 是 使 用 Toast 作 为 提示 工具 的 ， 本 小 节 我 们 就 来 学 习 一 个 Material 库 提供 的 更 加 先进 的 
提示 工具 一 一 Snackbar。 


首先 要 明确 ,Snackbar 并 不 是 Toast 的 替代 品 ， 它们 有 着 不 同 的 应 用 场景 。Toast 的 作用 是 告 ; 
用 户 现在 发 生 了 什么 事情 ,但 用 户 只 能 被 动 接收 这 个 事情 ， 因 为 没有 什么 办 法 能 让 用 户 进行 选 
择 。 而 Snackbar 则 在 这 方面 进行 了 扩展 ， 它 允许 在 提示 中 加 入 一 个 可 交互 按钮 ， 当 用 户 点 击 按 
钮 的 时 候 ， 可 以 执行 一 些 额外 的 逻辑 操作 。 打 个 比方 ， 如 果 我 们 在 执行 删除 操作 的 时 候 只 弹出 
一 个 Toast 提 示 ， 那 么 用 户 要 是 误 删 了 某 个 重要 数据 的 话 ， 肯定 会 十 分 抓 狂 吧 ,但 是 如 果 我 们 增 
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加 一 个 Undo 按 钮 ， 就 相当 于 给 用 户 提供 了 一 种 弥补 措施 ， 从 而 大 大 降低 了 事故 发 生 的 概率 ， 提 
升 了 用 户 体验 。 


Snackbar 的 用 法 也 非常 简单 ， 它 和 Toast 是 基本 相似 的 ， 只 不 过 可 以 额外 增加 一 个 按钮 的 点 击 
事件 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


fab.setOnClickListener { view -> 
Snackbar.make(view, "Data deleted", Snackbar.LENGTH SHORT) 
.SetAction("Undo") { 
Toast.makeText(this, "Data restored", Toast.LENGTH SHORT).show() 


.Show() 


} 


可 以 看 到 ， 这 里 调用 了 Snackbar 的 make( ) 方 法 来 创建 一 个 Snackbar 对 象 。make ( ) 方 法 的 第 
一 个 参数 需要 传 入 一 个 View， 只 要 是 当前 界面 布局 的 任意 一 个 View 都 可 以 , Snackbar 会 使 用 
这 个 View 自 动 查找 最 外 层 的 布局 , 用 于 展示 提示 信息 ; 第 二 个 参数 就 是 Snackbar 中 显示 的 内 
容 ; 第 三 个 参数 是 Snackbar 显 示 的 时 长 ,这些 和 Toast 都 是 类 似 的 。 


接着 这 里 又 调用 了 一 个 setAction () 方 法 来 设置 一 个 动作 ， 从 而 让 Snackbar 不 仅仅 是 一 个 提 
* ,而 是 可 以 和 用 户 进 行 交互 的 。 简 单 起 见 ,我们 在 动作 按钮 的 点 击 事件 里 面 弹出 一 个 Toast 提 
示 。 最 后 调用 show( ) 方 法 让 Snackbar 显 示 出 来 。 


现在 重新 运行 一 下 程序 , 并 点 击 悬 浮 按钮 ， 效 果 如 图 12.11 所 示 。 


Bl 
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Data deleted 


图 12.11 Snackbar 的 效果 


可 以 看 到 ,Snackbar 从 屏幕 底部 出 现 了 ， 上 面 有 我 们 设置 的 提示 文字 , 还 有 一 个 “Undo" 按 
钮 ， 按钮 是 可 以 点 击 的 。 过 一 段 时 间 后 ， Snackbar 会 自动 从 屏幕 底部 消失 。 


不 管 是 出 现 还 是 消失 , Snackbar 都 是 带 有 动画 效果 的 ， 因 此 视觉 体验 也 会 比较 好 。 

不 过 ， 你 有 没有 发 现 一 个 bug ? 这 个 Snackbar 竟 然 将 我 们 的 悬浮 按钮 给 遮挡 住 了 。 虽 说 也 不 是 
什么 重大 的 问题 ， 因 为 Snackbar 过 一 会 儿 就 会 自动 消失 ， 但 这 种 用 户 体验 总 归 是 不 友好 的 。 有 
没有 什么 办 法 能 解决 一 下 呢 ? 当然 有 了 ,只 需要 借助 CoordinatorLayout 就 可 以 轻松 解决 。 
12.4.3 CoordinatorLayout 


CoordinatorLayout 可 以 说 是 一 个 加 强 版 的 FrameLayout , 由 AndroidX 库 提供 。 它 在 普通 情 
况 下 的 作用 和 FrameLayout 基 本 一 致 , 但 是 它 拥 有 一 些 额 外 的 Material 能 
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事实 上 ，CoordinatorLayout 可 以 监听 其 所 有 子 控件 的 各 种 事件 ， 并 自动 帮助 我 们 做 出 最 为 合 
理 的 响应 。 举 个 简单 的 例子 ， 刚 才 弹 出 的 Snackbar 提 示 将 悬浮 按钮 遮挡 住 了 ， 而 如 果 我 们 能 让 
CoordinatorLayout 监 听 到 Snackbar 的 弹出 事件 ， 那 么 它 会 自动 将 内 部 的 
FloatingActionButton 向 上 偏 移 ， 从 而 确保 不 会 被 Snackbar 遮 挡 。 


至 于 CoordinatorLayout 的 使 用 也 非常 简单 ， 我们 只 需要 将 原来 的 FFameLayout 替 换 一 下 就 可 
以 了 。 修 改 activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<androidx,.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.coordinatorlayout .widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


<com.google.android.material.floatingactionbutton.FloatingActionButton 
android:id="@+id/fab" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout gravity="bottom|end" 
android:layout margin="16dp" 
android:src="@drawable/ic done" /> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


</androidx.drawerlayout.widget.DrawerLayout> 


由 于 CoordinatorLayout 本 身 就 是 一 个 加 强 版 的 FFameLayout, 因此 这 种 替换 不 会 有 任何 的 副 
作用 。 现 在 重新 运行 一 下 程序 ， 并 点击 悬浮 按钮 ， 效 果 如 图 12.12 所 示 。 
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Data deleted 


图 12.12 CoordinatorLayout 自 动 将 悬浮 按钮 上 移 


可 以 看 到 ,悬浮 按 钮 自动 向 上 偏 移 了 Snackbar 的 同等 高 度 ， 从 而 确保 不 会 被 遮挡 。 当 
Snackbar 消 失 的 时 候 ， 巧 浮 按钮 会 自动 向 下 偏 移 回 到 原来 的 位 置 。 


另外 ， 悬 浮 按钮 的 向 上 和 向 下 偏 移 也 是 伴随 着 动画 效果 的 ， 且 和 Snackbar 完 全 同步 ， 整 体 效果 
看 上 去 特别 赏 ' 心 悦目。 


不 过 我 们 回 过 头 来 再 思考 一 下 ， 刚 才 说 的 是 CoordinatorLayout 可 以 监听 其 所 有 子 控件 的 各 种 
事件 ,但 是 Snackbar 好 像 并 不 是 CoordinatorLayout 的 子 控 件 吧 ， 为 什么 它 却 可 以 被 监听 到 
呢 ? 


其 实 道理 很 简单 ， 还 记得 我 们 在 Snackbar 的 make( ) 方 法 中 传 入 的 第 一 个 参数 吗 ? 这 个 参数 就 
是 用 来 指定 Snackbar 是 基于 哪个 View 触 发 的 ， 刚 才 我 们 传 入 的 是 FloatingActionButton 本 
身 ,而 FloatingActionButton 是 CoordinatorLayout 中 的 子 控件 ,因此 这 个 事件 就 理 所 应 当 能 
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被 监听 到 了 。 你 可 以 自己 再 做 个 实验 ， 如 果 给 Snackbar 的 make ( ) 方 法 传 入 一 个 
DrawerLayout, 那么 Snackbar 就 会 再 次 遮挡 悬浮 按钮 ， 因 为 DrawerLayout 不 是 
CoordinatorLayout 的 子 控 件 ,CoordinatorLayout 也 就 无 法 监听 到 Snackbar 的 弹出 和 隐藏 
事件 了 。 


本 节 的 内 容 就 讲 到 这 里 ， 接 下 来 我 们 继续 丰富 MaterialTest 项 目 ， 加 入 卡片 式 布局 效果 。 
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12.5 卡片 式 布 局 


虽然 现在 MaterialTest 中 已 经 应 用 了 非常 多 的 Material Design 效 果 ， 不 过 你 会 发 现 ， 界 面 上 最 
主要 的 一 块 区 域 还 处 于 空白 状态 。 这 块 区 域 通常 用 来 放置 应 用 的 主体 内 容 ， 我 准备 使 用 一 些 精 
美的 水 果 图 片 来 填充 这 部 分 区 域 。 


为 了 要 让 水 果 图 片 也 能 Material 化 ， 本 节 中 我 们 将 会 学 习 如 何 实现 卡片 式 布局 的 效果 。 卡 片 式 
布局 也 是 Materials Design 中 提出 的 一 个 新 概念 ， 它 可 以 让 页 面 中 的 元 素 看 起 来 就 像 在 卡片 中 
一 样 ， 并 且 还 能 拥有 圆 角 和 投影 ,下 面 我 们 就 开始 具体 学 习 一 下 。 


12.5.1 MaterialCardView 


MaterialCardView 是 用 于 实现 卡片 式 布局 效果 的 重要 控件 ， 由 Material 库 提供 。 实 际 上 ， 
MaterialCardView 也 是 一 个 FrameLayout , 只 是 额外 提供 了 圆 角 和 阴影 等 效果 ， 看 上 去 会 有 
立体 的 感觉 。 


我 们 先 来 看 一 下 MaterialCardView 的 基本 用 法 吧 ， 其 实 非 常 简单 ， 如 下 所 示 : 


<com.google.android.material.card.MaterialCardView 
android:layout width="match parent" 
android:layout height="wrap content" 
app:cardCornerRadius="4dp" 
app:elevation="5dp"> 
<TextView 
android:id="@+id/infoText" 
android:layout width="match parent" 
android:layout height="wrap content"/> 
</com.google.android.material.card.MaterialCardView> 


这 里 定义 了 一 个 MaterialCardView 布 局 , 我 们 可 以 通过 app:cardCornerRadius 属 性 指定 卡 
片 圆 角 的 弧度 ， 数 值 越 大 ， 圆 角 的 弧度 也 越 大 。 另 外 ， 还 可 以 通过 app :elevation 属 性 指定 卡 
片 的 高 度 : 高 度 值 越 大 ， 投影 范围 也 越 大 ， 但 是 投影 效果 越 淡 ; 高 度 值 越 小 ,投影 范围 也 越 

小 , 但 是 投影 效果 越 浓 。 这 一 点 和 FloatingActionButton 是 一 致 的 。 


然后 ,我 们 在 MaterialCardView 布 局 中 放置 了 一 个 TextView , 那么 这 个 TextView 就 会 显示 在 
一 张 卡 片 当中 了 ， 就 是 这 么 简单 。 

但 是 , 我 们 显然 不 可 能 在 如 此 宽阔 的 一 块 空白 区 域内 只 放置 一 张 卡片 。 为 了 能 够 充分 利用 屏幕 
的 空间 ,这 里 我 准备 综合 运用 一 下 第 4 章 中 学 到 的 知识 ， 使 用 RecyclerView 填 充 MaterialTest 
项 目的 主 界 面部 分 。 还 记得 之 前 实现 过 的 水 果 列 表 效果 吗 ? 这 次 我 们 将 升级 一 下 ， 实 现 一 个 高 
配 版 的 水 果 列 表 效果 。 

既然 是 要 实现 水 果 列 表 , 那么 首先 肯定 需要 准备 许多 张 水 果 图 片 , 这 里 我 从 网 上 挑选 了 一 些 精 
美的 水 果 图 片 ， 将 它们 复制 到 了 项 目 当中 (资源 下 载 方式 见 前 言 ) 。 

然后 ,由 于 我 们 还 需要 用 到 RecyclerView ,因此 必须 在 app/build.gradle 文 件 中 声明 库 的 依 


赖 : 
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dependencies { 


implementation 'androidx.recyclerview:recyclerview:1.0.0' 
implementation 'com.github.bumptech.glide:glide:4.9.0" 


上 述 声 明 的 第 二 行 是 添加 了 Glide 库 的 依赖 。Glide 是 一 个 超级 强大 的 开源 图 片 加 载 库 ， 它 不 仅 
可 以 用 于 加 载 本 地 图 片 ， 还 可 以 加 载 网 络 图 片 、GIF 图 片 甚至 是 本 地 视频 。 最 重要 的 是 ，Glide 
的 用 法 非常 简单 ， 只 需 几 行 代 码 就 能 轻松 实现 复杂 的 图 片 加 载 功能 ， 因 此 这 里 我 们 准备 用 它 来 
加 载 水 果 图 片 。Glide 的 项 目 主页 地 址 是 : https:/github.com/bumptech/glide。 


接 下 来 开始 具体 的 代码 实现 ， 修 改 activity_main.xml 中 的 代码 ,如 下 所 示 : 


<androidx,.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.coordinatorlayout .widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" /> 


<com.google.android.material.floatingactionbutton.FloatingActionButton 
android:id="@+id/fab" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:Layout gravity="bottom|end" 
android:layout margin="16dp" 
android:src="@drawable/ic done" /> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


</androidx.drawerlayout.widget.DrawerLayout> 


这 里 我 们 在 CoordinatorLayout 中 添加 了 一 个 RecyclerView ,给 它 指 定 一 个 id ， 然 后 将 宽度 和 
高 度 都 设置 为 natch_parent ,这样 RecyclerView 就 占 满 了 整个 布局 的 空间 。 


接着 定义 一 个 实体 类 Fruit , 代码 如 下 所 示 : 


class Fruit(val name: String, val imageId: Int) 


Fruit 类 中 只 有 两 个 字段 : name 表 示 水 果 的 名 字 ，imageId 表 示 水 果 对 应 图 片 的 资源 id。 
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然后 需要 为 RecyclerView 的 子 项 指定 一 个 我 们 自 定义 的 布局 ,在 layout 目 录 下 新 建 
fruit_ item.xml , 代码 如 下 所 示 : 


<com.google.android.material.card.MaterialCardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="5dp" 
app:cardCornerRadius="4dp"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<ImageView 
android:id="@+id/fruitImage" 
android:layout width="match parent" 
android:layout height="100dp" 
android:scaleType="centerCrop" /> 


<TextView 

android:id="@+id/fruitName" 

android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:layout margin="5dp" 
android:textSize="16sp" /> 

</LinearLayout> 


</com.google.android.material.card.MaterialCardView> 


这 里 使 用 了 MaterialCardView 来 作为 子 项 的 最 外 层 布 局 ,从 而 使 得 RecyclerView 中 的 每 个 元 
素 都 是 在 卡片 当中 的 。 由 于 MaterialCardView 是 一 个 FrameLayout , 因此 它 没有 什么 方便 的 
定位 方式 ， 这 里 我 们 只 好 在 MaterialCardView 中 再 笠 套 一 个 LinearLayout , 然后 在 
LinearLayout 中 放置 具体 的 内 容 。 


内 容 倒 也 没有 什么 特殊 的 地 方 ， 就 是 定义 了 一 个 ImageView 用 于 显示 水 果 的 图 片 , 又 定义 了 一 
个 TextView 用 于 显示 水 果 的 名 称 ， 并 让 TextView 在 水 平方 向 上 居中 显示 。 注 意 ,在 
ImageView 中 我 们 使 用 了 一 个 scaLeType 属 性 ， 这 个 属性 可 以 指定 图 片 的 缩放 模式 。 由 于 各 张 
水 果 图 片 的 长 宽 比 例 可 能 会 不 一 致 ， 为 了 让 所 有 的 图 片 都 能 填充 满 整 个 ImageView , 这 里 使 用 
了 centerCrop 模 式 ， 它 可 以 让 图 片 保 持原 有 比例 填充 满 ImageView， 并 将 超出 屏幕 的 部 分 裁 
剪 掉 。 


接 下 来 需要 为 RecyclerView 准 备 一 个 适配器 ， 新 建 FruitAdapter 类 ， 让 这 个 适配器 继承 自 
RecyclerView.Adapter ,并 将 泛 型 指定 为 FruitAdapterViewHolder ,代码 如 下 所 示 : 


class FruitAdapter(val context: Context, val fruitList: List<Fruit>) 
RecyclerView.Adapter<FruitAdapter.ViewHolder>() { 


inner class ViewHolder(view: View) : RecyclerView.ViewHolder(view) { 
val fruitImage: ImageView = view.findViewById(R.id.fruitIimage) 
val fruitName: TextView = view.findViewById(R.id.fruitName) 


} 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
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val view = LayoutInfLater.from(context).infLate(R.Layout.fruit item, parent, false) 
return ViewHolder (view) 


} 


override fun onBindViewHolder(holder: ViewHolder, position: Int) { 
val fruit = fruitList[position] 
holder.fruitName.text = fruit.name 
Glide.with(context).load(fruit.imagelId).into(holder.fruitImage) 
} 


override fun getItemCount() = fruitList.size 


} 


上 述 代码 相信 你 一 定 很 熟悉 ， 和 我 们 在 第 4 章 中 编写 的 FruitAdapter 基 本 一 模 一 样 。 唯 一 需要 注 
意 的 是 ,在 onBindViewHolder() 方 法 中 我 们 使 用 了 Glide 来 加 载 水 果 图 片 。 


那么 这 里 就 顺便 来 看 一 下 Glide 的 用 法 吧 ,其实 并 没有 太 多 好 讲 的 ， 因 为 Glide 的 用 法 实在 是 太 
简单 了 。 首 先 调用 GLide .with() 方 法 并 传 入 一 个 Context、Activity 或 Fragment 参 数 ， 
然后 调用 Load ( ) 方 法 加 载 图 片 , 可 以 是 一 个 URL 地 址 , 也 可 以 是 一 个 本 地 路 径 ， 或 者 是 一 个 资 
源 id ,最 后 调用 into( ) 方 法 将 图 片 设 置 到 具体 某 一 个 ImageView 中 就 可 以 了 。 


那么 我 们 为 什么 要 使 用 Glide 而 不 是 传统 的 设置 图 片 方式 呢 ? 因为 这 次 我 从 网 上 找 的 这 些 水 果 图 
片 像素 非常 高 ， 如 果 不 进行 压缩 就 直接 展示 的 话 ， 很 容易 引起 内 存 溢出 。 而 使 用 Glide 就 完全 不 
需要 担心 这 回 事 ，Glide 在 内 部 做 了 许多 非常 复杂 的 逻辑 操作 ， 其 中 就 包括 了 图 片 压 缩 ， 我 们 只 
需要 安心 按照 Glide 的 标准 用 法 去 加 载 图 片 就 可 以 了 。 


这 样 我 们 将 RecyclerView 的 适配器 也 ;准备 好 了 ,最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


val fruits = mutableList0f(Fruit("Apple", R.drawable.apple), Fruit("Banana", 
R.drawable.banana), Fruit("Orange", R.drawable.orange), Fruit("Watermelon", 
R.drawable.watermelon), Fruit("Pear", R.drawable.pear), Fruit("Grape", 
R.drawable.grape), Fruit("Pineapple", R.drawable.pineapple), Fruit("Strawberry", 
R.drawable.strawberry), Fruit("Cherry", R.drawable.cherry), Fruit("Mango", 
R.drawable.mango)) 


val fruitList = ArrayList<Fruit>() 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


initFruits() 

val layoutManager = GridLayoutManager(this, 2) 
recyclerView.layoutManager = layoutManager 
val adapter = FruitAdapter(this, fruitList) 
recyclerView.adapter = adapter 


} 


private fun initFruits() { 
fruitList.clear() 
repeat(50) { 
val index = (0 until fruits.size).random() 
fruitList.add(fruits[index]) 
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} 


在 MainActivity 中 ,我 们 首先 定义 了 一 个 水 果 和 集合 ， 集合 里 面 存放 了 很 多 个 Fruit 的 实例 , 每 
个 实例 都 代表 一 种 水 果 。 然 后 在 initFruits() 方 法 中 ， 先 是 清空 了 一 下 fruitList 中 的 数 
据 , 接着 使 用 一 个 随机 函数 ， 从 刚才 定义 的 Fruit 数 组 中 随机 挑选 一 个 水 果 放 入 fruitList 当 
中 ， 这 样 每 次 打开 程序 看 到 的 水 果 数 据 都 会 是 不 同 的 。 另 外 ， 为 了 让 界面 上 的 数据 多 一 些 ， 这 
里 使 用 了 repeat ( ) 范 数 ， 随 机 挑选 50 个 水 果 。 


之 后 的 用 法 就 是 RecyclerView 的 标准 用 法 了 ， 不 过 这 里 使 用 了 GridLayoutManager 这 种 布局 
方式 。 在 第 4 章 中 我 们 已 经 学 过 了 LinearLayoutManager 和 
StaggeredGridLayoutManager , 现在 终于 将 所 有 的 布局 方式 都 补 齐 了 。 
GridLayoutManager 的 用 法 也 没有 什么 特别 之 处 ， 它 的 构造 函数 接收 两 个 参数 : 第 一 个 是 
Context ,第 二 个 是 列 数 。 这 里 我 们 希望 每 一 行 中 会 有 两 列 数据 。 


现在 重新 运行 一 下 程序 ， 效果 如 图 12.13 所 示 。 
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Pineapple 


Watermelon 


Pear Cherry 


Orange Apple 


图 12.13 卡片 式 布局 效果 


可 以 看 到 ， 精 美的 水 果 图 片 成 功 展示 出 来 了 。 每 个 水 果 都 是 在 一 张 单独 的 卡片 当中 的 ， 并 且 还 
拥有 圆 角 和 投影 ， 是 不 是 非常 美观 ? 另外 ， 由 于 我 们 是 使 用 随机 的 方式 来 获取 水 果 数 据 的 ， 
此 界面 上 会 有 一 些 重复 的 水 果 出 现 ， 这 属于 正常 现象 。 


当 你 陶醉 于 当前 精美 的 界面 的 时 候 ， 你 是 不 是 忽略 了 一 个 细节 ?哎呀 ,我 们 的 Toolbar 怎 么 不 见 
了 ! 仔细 观察 一 下 原来 是 被 RecyclerView 给 挡住 了 。 这 个 问题 又 该 怎么 解决 呢 ? 这 就 需要 借助 
另外 一 个 工具 了 一 一 AppBarLayout。 


12.5.2 AppBarLayout 


首先 ， 我 们 来 分 析 一 下 为 什么 RecyclerView 会 把 Toolbar 给 遮挡 住 吧 。 其 实 并 不 难 理解 ， 由 于 
RecyclerView 和 Toolbar 都 是 放置 在 CoordinatorLayout 中 的 ， 而 前 面 已 经 说 过 ， 
CoordinatorLayout 就 是 一 个 加 强 版 的 FFameLayout , 那么 FrameLayout 中 的 所 有 控件 在 不 
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进行 明确 定位 的 情况 下 ， 默 认 都 会 摆 放 在 布局 的 左上 和 角 ， 从 而 产生 了 遮挡 的 现象 。 其 实 这 已 经 
不 是 你 第 一 次 遇 到 这 种 情况 了 ， 我们 在 4.3.3 小 节 学 习 FrameLayout 的 时 候 ， 就 早已 见识 过 了 
控件 与 控件 之 间 遮 挡 的 效果 。 


既然 已 经 找到 了 问题 的 原因 ， 那么 该 如 何 解决 呢 ? 在 传统 情况 下 ， 使 用 偏 移 是 唯一 的 解决 办 

法 ，, 即 让 RecyclerView 向 下 偏 移 一 个 Toolbar 的 高 度 ， 从 而 保证 不 会 遮挡 到 Toolbar。 不 过 我 们 
使 用 的 并 不 是 普通 的 FrameLayout , 而 是 CoordinatorLayout , 因此 自然 会 有 一 些 更 加 巧妙 的 
解决 办 法 。 


这 里 我 准备 使 用 Material 库 中 提供 的 另外 一 个 工具 一 一 AppBarLayout。AppBarLayout 实 际 
上 是 一 个 垂直 方向 的 LinearLayout , 它 在 内 部 做 了 很 多 滚动 事件 的 封装 ， 并 应 用 了 一 些 
Material Design 的 设计 理念 。 


那么 我 们 怎样 使 用 AppBarLayout 才 能 解决 前 面 的 遮挡 问题 呢 ? 其 实 只 需要 两 步 就 可 以 了 ， 第 
一 步 将 Toolbar 棱 套 到 AppBarLayout 中 ， 第 二 步 给 RecyclerView 指 定 一 个 布局 行为 。 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<androidx,.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 

android:layout width="match parent" 

android:layout height="match parent"> 


<androidx.coordinatorlayout.widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.google.android.material.appbar.AppBarLayout 
android:layout width="match parent" 
android:layout height="wrap content"> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</com.google.android.material.appbar.AppBarLayout> 
<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior" /> 
</androidx.coordinatorlayout.widget.CoordinatorLayout> 


</androidx.drawerlayout .widget,DrawerLayout> 


可 以 看 到 ， 布 局 文件 并 没有 什么 太 大 的 变化 。 我 们 首先 定义 了 一 个 AppBarLayout， 并 将 
Toolbar 放 置 在 了 AppBarLayout 里 面 , 然后 在 RecyclerView 中 使 用 app: layout behavior 
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属性 指定 了 一 个 布局 行为 。 其 中 appbar_scrolling view behavior 这 个 字符 串 也 是 由 
Material 库 提供 的 。 


现在 重新 运行 一 下 程序 ， 你 就 会 发 现 一 切 都 正常 了 ， 如 图 12.14 所 示 。 


Fruits 


Cherry 


Pineapple Watermelon 


Cherry 


图 12.14 解决 RecyclerView 迹 挡 Toolbar 的 问题 


虽说 使 用 AppBarLayout 已 经 成 功 解决 了 RecyclerView 遮 挡 Toolbar 的 问题 ， 但 是 刚才 提 到 

过 ,AppBarLayout 中 应 用 了 一 些 Material Design 的 设计 理念 ， 好 像 从 上 面 的 例子 完全 体现 不 
出 来 吁 。 事 实 上 , 当 RecyclerView 滚 动 的 时 候 就 已 经 将 滚动 事件 通知 给 AppBarLayout 了 ， 只 
是 我 们 还 没 进行 处 理 而 已 。 那 么 下 面 就 让 我 们 来 进一步 优化 ， 看 看 AppBarLayout 到 底 能 实现 
什么 样 的 Material Design 效 果 。 


当 AppBarLayout 接 收 到 滚动 事件 的 时 候 ， 它 内 部 的 子 控件 其 实 是 可 以 指定 如 何 去 响 应 这 些 事 
件 的 ， 通 过 app:Layout_scroLLFLags 属 性 就 能 实现 。 修 改 activity_main.xml 中 的 代码 ， 
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如 下 所 示 : 


<androidx.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.coordinatorlayout .widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.google.android.material.appbar.AppBarLayout 
android:layout width="match parent" 
android:layout height="wrap content"> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
android:background="@color/colorPrimary" 
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 
app:popupTheme="@style/ThemeOverlay.AppCompat Light" 
app:Layout scrollFlags="scroll|enterAlways|snap" /> 


</com.google.android.material .appbar.AppBarLayout> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


</androidx.drawerlayout.widget.DrawerLayout> 


这 里 在 Toolbar 中 添加 了 一 个 app:layout scrollFlags 属 性 ,并 将 这 个 属性 的 值 指定 成 了 
scroLLlenterALways|snap。 其 中 ,scroLL 表 示 当 RecyclerView 向 上 滚动 的 时 候 ， 
Toolbar 会 跟着 一 起 向 上 滚动 并 实现 隐藏 ; enterALways 表 示 当 RecyclerView 向 下 滚动 的 时 
候 ，Toolbar 会 跟着 一 起 向 下 滚动 并 重新 显示 ; snap 表 示 当 Toolbar 还 没有 完全 隐藏 或 显示 的 时 
候 ， 会 根据 当前 滚动 的 距离 ， 自 动 选 择 是 隐藏 还 是 显示 。 


我 们 要 改动 的 就 只 有 这 一 行 代码 而 已 ， 现 在 重新 运行 一 下 程序 , 并 向 上 滚动 RecyclerView , 效 
果 如 图 12.15 所 示 。 
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图 12.15 向 上 滚动 RecyclerView 隐 藏 Toolbar 


可 以 看 到 ， 随 着 我 们 向 上 滚动 RecyclerView , Toolbar 竟 然 消 失 了 ! 而 向 下 滚动 
RecyclerView ,Toolbar 又 会 重新 出 现 。 这 其 实 也 是 Material Design 中 的 一 项 重要 设计 思 

想 ， 因 为 当 用 户 在 向 上 滚动 RecyclerView 的 时 候 ， 其 注意 力 肯定 是 在 RecyclerView 的 内 容 上 
的 ， 这 个 时 候 如 果 Toolbar 还 占据 着 屏幕 空间 ， 就 会 在 一 定 程度 上 影响 用 户 的 阅读 体验 ， 而 将 
Toolbar 隐 藏 则 可 以 让 阅读 体验 达到 最 佳 状态 。 当 用 户 需 要 操作 Toolbar 上 的 功能 时 ， 只 需要 轻 
微 向 下 滚动 ，Toolbar 就 会 重新 出 现 。 这 种 设计 方式 既 保 证 了 用 户 的 最 佳 阅读 效果 ， 又 不 影响 任 
何 功能 上 的 操作 ，Material Design 考 虑 得 就 是 这 么 细致 入 微 。 


当然 了 ， 像 这 种 功能 ， 如 果 是 使 用 ActionBar 的 话 ， 那 就 完全 不 可 能 实现 了 ，Toolbar 的 出 现 为 
我 们 提供 了 更 多 的 可 能 。 
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12.6 ”下拉 刷 新 


下 拉 刷 新 这 种 功能 早 就 不 是 什么 新 鲜 的 东西 了 ， 所 有 的 应 用 里 都 会 有 这 个 功能 。 不 过 市 面 上 现 
有 的 下 拉 刷 新 功能 在 风格 上 各 不 相同 ， 并且 和 Material Design 还 有 些 格格 不 入 的 感觉 。 因 此 ， 
Google 为 了 让 Android 的 下 拉 刷 新 风格 能 有 一 个 统一 的 标准 ， 在 Material Design 中 制定 了 一 
个 官方 的 设计 规范 。 当 然 ， 我 们 并 不 需要 深入 了 解 这 个 规范 到 底 是 什么 样 的 ,因为 Google 早 就 
提供 好 了 现成 的 控件 ， 我 们 在 项 目 中 直接 使 用 就 可 以 了 。 
SwipeRefreshLayout 就 是 用 于 实现 下 拉 刷 新 功能 的 核心 类 ， 我 们 把 想 要 实现 下 拉 刷 新 功能 
控件 放置 到 SwipeRefreshLayout 中 ， 就 可 以 迅速 让 这 个 控件 支持 下 拉 刷 新 。 那 么 在 
MaterialTest 项 目 中 ,应 该 支持 下 拉 刷 新 功能 的 控件 自然 就 是 RecyclerView 了 。 


使 用 SwipeRefreshLayout 之 前 首先 需要 在 app/build.gradle 文 件 中 添加 如 下 依赖 : 


dependencies { 


implementation?"androidx.swiperefreshlayout:swiperefreshlayout:1.0.0" 


} 


由 于 SwipeRefreshLayout 的 用 法 也 比较 简单 ， 下面 我 们 就 直接 开始 使 用 了 。 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<androidx,.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.coordinatorlayout .widget.CoordinatorLayout 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.swiperefreshlayout.widget.SwipeRefreshLayout 
android:id="@+id/swipeRefresh" 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior"> 


<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior" /> 


</androidx.swiperefreshlayout.widget.SwipeRefreshLayout> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


</androidx.drawerlayout .widget,DrawerLayout> 


可 以 看 到 ， 这 里 我 们 在 RecyclerView 的 外 面 又 钥 套 了 一 层 SwipeRefreshLayout , 这 样 
RecyclerView 就 自动 拥有 下 拉 刷 新 功能 了 。 另 外 需要 注意 ， 由 于 RecyclerView 现 在 变 成 了 
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SwipeRefreshLayout 的 子 控件 ， 因 此 之 前 使 用 app:Layout_behavior 声 明 的 布局 行为 现在 
也 要 移 到 SwipeRefreshLayout 中 才 行 。 


不 过 这 还 没有 结束 ， 虽 然 RecyclerView 已 经 支持 下 拉 刷 新 功能 了 ， 但 是 我 们 还 要 在 代码 中 处 理 
具体 的 刷新 逻辑 才 行 。 修 改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


swipeRefresh.setColorSchemeResources(R.color.colorPrimary) 
swipeRefresh.setOnRefreshListener { 
refreshFruits(adapter) 


} 
private fun refreshFruits(adapter: FruitAdapter) { 
thread { 
Thread. sleep(2000) 
runOnUiThread { 
initFruits() 
adapter.notifyData9etChanged () 
swipeRefresh.isRefreshing = false 
} 


} 


这 上段 代码 应 该 还 是 比较 好 理解 的 ， 首先 调用 SwipeRefreshLayout 的 
setCoLorSchemeResources () 方 法 来 设置 下 拉 刷 新 进度 条 的 颜色 ,这 里 我 们 就 使 用 主题 中 
的 coLorPrimary 作 为 进度 条 的 颜色 了 。 接 着 调用 set0nRef reshListener( ) 方 法 来 设置 一 
个 下 拉 刷 新 的 监听 器 ， 当 用 户 进行 了 下 拉 刷 新 操作 时 ， 就 会 回调 到 Lambda 表 达 式 当中 ， 然 后 
我 们 在 这 里 去 处 理 具体 的 刷新 逻辑 就 可 以 了 。 


通常 情况 下 ， 当 触发 了 下 拉 刷 新 事件 ， 应 该 是 去 网 络 上 请 求 最 新 的 数据 ， 然 后 再 将 这 些 数据 展 
示 出 来 。 这 里 简单 起 见 ， 我 们 就 不 和 网 络 进行 交互 了 ,而 是 调用 一 个 refreshFruits () 方 法 
进行 本 地 刷新 操作 。refreshFruits () 方 法 中 先是 开启 了 一 个 线程 ， 然 后 将 线程 沉睡 两 秒 
钟 。 之 所 以 这 么 做 ,是 因为 本 地 刷新 操作 速度 非常 快 ， 如 果 不 将 线程 沉睡 的 话 ， 刷 新 立刻 就 结 
束 了 ,从 而 看 不 到 刷新 的 过 程 。 沉 睡 结束 之 后 ， 这 里 使 用 了 run0nUiTh read ( ) 方 法 将 线程 切 
换 回 主线 程 ， 然 后 调用 initFruits() 方 法 重新 生成 数据 ， 接着 再 调用 FruitAdapter 的 
notifyDataSetChanged() 方 法 通知 数据 发 生 了 变化 , 最 后 调用 SwipeRefreshLayout 的 
setRefreshing() 方 法 并 传 入 false , 表示 刷新 事件 结束 ， 并 隐藏 刷新 进度 条 。 


现在 可 以 重新 运行 一 下 程序 了 ， 在 屏幕 的 主 界面 向 下 拖 动 ， 会 有 一 个 下 拉 刷 新 的 进度 条 出 现 ， 
松 于 后 就 会 自动 进行 刷新 了 ， 效 果 如 图 12.16 所 示 。 
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Fruits 


图 12.16 ”实现 下 拉 刷 新 效果 
下 拉 刷 新 的 进度 条 只 会 停留 两 秒 钟 ， 之 后 就 会 自动 消失 ， 界 面 上 的 水 果 数 据 也 会 随 之 更 新 。 


这 样 我 们 就 把 下 拉 刷 新 的 功能 也 成 功 实现 了 ， 并 且 这 就 是 Material Design 中 规定 的 最 标准 的 下 
拉 刷 新 效果 ， 还 有 什么 会 比 这 个 更 好 看 呢 ? 目前 我 们 的 项 目 中 已 经 应 用 了 众多 Material Design 
的 效果 ，Material 库 中 的 常用 控件 也 学 了 大 半 了 。 不 过 本 章 的 学 习 之 旅 还 没有 结束 ， 在 最 后 的 
尾声 部 分 ， 我 们 再 来 实现 一 个 非常 震撼 的 Material Design 效 果 一 一 可 折 肢 式 标题 栏 。 
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12.7 可 折 赫 式 标 题 栏 


虽说 我 们 现在 的 标题 栏 是 使 用 Toolbar 来 编写 的 ， 不 过 它 看 上 去 和 传统 的 ActionBar 没 什么 两 
样 ， 只 不 过 可 以 响应 RecyclerView 的 滚动 事件 来 进行 隐藏 和 显示 。 而 Material Design 中 并 没 
有 限定 标题 栏 必须 是 长 这 个 样子 的 ， 事 实 上 ， 我 们 可 以 根据 自己 的 喜好 随意 定制 标题 栏 的 样 
式 。 那 么 本 节 中 我 们 就 来 实现 一 个 可 折 辣 式 标题 栏 的 效果 ， 这 需要 借助 
CollapsingToolbarLayout 这 个 工具 。 


12.7.1 CollapsingToolbarLayout 


顾名思义 ，CollapsingToolbarLayout 是 一 个 作用 于 Toolbar 基 础 之 上 的 布局 , 它 也 是 由 
Material 库 提供 的 。CollapsingToolbarLayout 可 以 让 Toolbar 的 效果 变 得 更 加 丰富 ， 不 仅仅 是 
展示 一 个 标题 栏 , 而 且 能 够 实现 非常 华丽 的 效果 。 


不 过 ，CollapsingToolbarLayout 是 不 能 独立 存在 的 ， 它 在 设计 的 时 候 就 被 限定 只 能 作为 
AppBarLayout 的 直接 子 布局 来 使 用 。 而 AppBarLayout 又 必须 是 CoordinatorLayout 的 子 布 
局 ， 因 此 本 节 中 我 们 要 实现 的 功能 其 实 需要 综合 运用 前 面 所 学 的 各 种 知识 。 那 么 话 不 多 说 ， 这 
就 开始 吧 。 

首先 我 们 需要 一 个 额外 的 Activity 作 为 水 果 的 详情 展示 界面 ， 右 击 com.example.materialtest 
包 -New=ActivityEmpty Activity， 创 建 一 个 FruitActivity， 并 将 布局 名 指定 成 
activity_fruit.xml， 然 后 我 们 开始 编写 水 果 详 情 展示 界面 的 布局 。 


由 于 整个 布局 文件 比较 复杂 ， 这 里 我 准备 采用 分 段 编 写 的 方式 。activity_fruit.xml 中 的 内 容 主 
要 分 为 两 部 分 ， 一 个 是 水 果 标 题 栏 ， 一 个 是 水 果 内 容 详情 ， 我 们 来 一 步 步 实现 。 


首先 实现 标题 栏 部 分 ， 这 里 使 用 CoordinatorLayout 作 为 最 外 层 布 局 , 如 下 所 示 : 


<androidx.coordinatorlayout.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


一 开始 的 代码 还 是 比较 简单 的 ， 相 信 没 有 什么 需要 解释 的 地 方 。 注 意 要 始终 记得 定义 一 个 
xmLns :app 的 命名 空间 ,在 Material Design 的 开发 中 会 经 常用 到 它 。 


接着 我 们 在 CoordinatorLayout 中 艇 套 一 个 AppBarLayout ,如 下 所 示 : 


<androidx.coordinatorlayout.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.google.android.material.appbar.AppBarLayout 
android:id="@+id/appBar" 
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android:layout width="match parent" 
android:layout height="250dp"> 
</com.google.android.material .appbar.AppBarLayout> 


</androidx.coordinatorlayout .widget.CoordinatorLayout> 


目前 为 止 也 没有 什么 难 理解 的 地 方 ， 我 们 给 AppBarLayout 定 义 了 一 个 id , 将 它 的 宽度 指定 为 
match_parent , 高 度 指 定 为 250 dp。 当 然 这 里 的 高 度 值 你 可 以 随意 指定 ， 不 过 我 尝试 之 后 发 
现 250 dp 的 视觉 效果 比较 好 。 


接 下 来 我 们 在 AppBarLayout 中 再 能 套 一 个 CollapsingToolbarLayout , 如 下 所 示 : 


<androidx,.coordinatorLayout .widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.google.android.material .appbar.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


<com.google.android.material.appbar.CollapsingToolbarLayout 
android:id="@+id/collapsingToolbar" 
android:layout width="match parent" 
android:layout height="match parent" 
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" 
app:contentScrim="@color/colorPrimary" 
app:Layout scrollFlags="scroll|exitUntilCollapsed"> 
</com.google.android.material.appbar.CollapsingToolbarLayout> 


</com.google.android.material .appbar.AppBarLayout> 


</androidx.coordinatorlayout .widget.CoordinatorLayout> 


从 现在 开始 就 稍微 有 点 难 理解 了 ， 这 里 我 们 使 用 了 新 的 布局 CollapsingToolbarLayout。 其 

中 , id、Layout width 和 Layout height 这 几 个 属性 比较 简单 ， 我 就 不 解释 了 。 

android:theme 属 性 指定 了 一 个 ThemeOverlayAppCompat.Dark.ActionBar 的 主题 ， 其 
实 对 于 这 部 分 我 们 也 并 不 陌生 ， 因 为 之 前 在 activity_main.xmL 中 给 Toolbar 指 定 的 也 是 这 个 
主题 ， 只 不 过 这 里 要 实现 更 加 高 级 的 Toolbar 效 果 ，, 因此 需要 将 这 个 主题 的 指定 提 到 上 一 层 来 。 
app:contentScrim 属 性 用 于 指定 CollapsingToolbarLayout 在 趋 于 折 肝 状态 以 及 折 赤 之 后 的 
背景 色 ,其实 CollapsingToolbarLayout 在 折 壳 之 后 就 是 一 个 普通 的 Toolbar ,那么 背景 色 肯定 
应 该 是 colorPrimary 了 ， 具体 的 效果 我 们 待 会 儿 就 能 看 到 。app:layout scrollFlags 属 
性 我 们 也 是 见 过 的 ， 只 不 过 之 前 是 给 Toolbar 指 定 的 ， 现在 也 移 到 外 面 来 了 。 其 中 ，scrol1 表 
示 CollapsingToolbarLayout 会 随 着 水 果 内 容 详情 的 滚动 一 起 滚动 , exitUntiLCoLLapsed 
表示 当 CollapsingToolbarLayout 随 着 滚动 完成 折 琶 之 后 就 保留 在 界面 上 ， 不 再 移出 屏幕 。 


接 下 来 ， 我 们 在 CollapsingToolbarLayout 中 定义 标题 栏 的 具体 内 容 ， 如 下 所 示 : 


<androidx.coordinatorlayout.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 
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<com.google.android.material.appbar.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


<com.google.android.material.appbar.CollapsingToolbarLayout 
android:id="@+id/collapsingToolbar" 
android:layout width="match parent" 
android:layout height="match parent" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
app:contentScrim="@color/colorPrimary" 
app:Layout scrollFlags="scroll|exitUntilCollapsed"> 


<ImageView 
android:id="@+id/fruitImageView" 
android:Layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
app:layout collapseMode="parallax" /> 


<androidx.appcompat .widget.Toolbar 
android:id="@+id/toolbar" 
android:Layout width="match parent" 
android:layout height="?attr/actionBarSize" 
app:layout collapseMode="pin" /> 
</com.google.android.material.appbar.CollapsingToolbarLayout> 
</com.google.android.material .appbar.AppBarLayout> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


可 以 看 到 ,我们 在 CollapsingToolbarLayout 中 定义 了 一 个 ImageView 和 一 个 Toolbar , 也 就 
意味 着 ， 这 个 高 级 版 的 标题 栏 将 是 由 普通 的 标题 栏 加 上 图 片 组 合 而 成 的 。 这 里 定义 的 大 多 数 属 
性 我 们 是 已 经 见 过 的 ， 就 不 再 解释 了 ， 只 有 一 个 app :Layout_coLLapseMode 比 较 陌 生 。 它 用 
于 指定 当前 控件 在 CollapsingToolbarLayout 折 至 过 程 中 的 折 酸 模式 ,其 中 Toolbar 指 定 成 
pin， 表示 在 折 亚 的 过 程 中 位 置 始终 保持 不 变 ， ImageView 指 定 成 parallax， 表示 会 在 折 肢 的 
过 程 中 产生 一 定 的 错位 偏 移 ， 这 种 模式 的 视觉 效果 会 非常 好 。 


这 样 我 们 就 将 水 果 标 题 栏 的 界面 编写 完成 了 ， 下 面 开始 编写 水 果 内 容 详情 部 分 。 继 续 修改 
activity fruit.xml 中 的 代码 ， 如 下 所 示 : 


<androidx,.coordinatorLayout .widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.google.android.material .appbar.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


</com.google.android.material.appbar.AppBarLayout> 


<androidx.core.widget.NestedScrollView 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior"> 
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</androidx.core.widget.NestedScrollView> 


</androidx.coordinatorlayout .widget.CoordinatorLayout> 


水 果 内 容 详 情 的 最 外 层 布 局 使 用 了 一 个 NestedScrollView , 注意 它 和 AppBarLayout 是 平 级 
的 。 我 们 之 前 在 11.2.1 小 节 学 过 ScrollView 的 用 法 ， 它 允许 使 用 滚动 的 方式 来 查看 屏幕 以 外 的 
数据 ,而 NestedScrollView 在 此 基础 之 上 还 增加 了 藤 套 响应 滚动 事件 的 功能 。 由 于 
CoordinatorLayout 本 身 已 经 可 以 响应 滚动 事件 了 ， 因 此 我 们 在 它 的 内 部 就 需要 使 用 
NestedScrollView 或 RecyclerView 这 样 的 布局 。 另 外 ,这 里 还 通过 app:Layout_behavior 
属性 指定 了 一 个 布局 行为 ， 这 和 之 前 在 RecyclerView 中 的 用 法 是 一 模 一 样 的 。 


不 管 是 ScrollView 还 是 NestedScrollView , 它们 的 内 部 都 只 允许 存在 一 个 直接 子 布局 。 因 此 ， 
如 果 我 们 想 要 在 里 面 放 入 很 多 东西 的 话 ， 通 常会 先 蔷 套 一 个 LinearLayout ,然后 再 在 
LinearLayout 中 放 入 具体 的 内 容 就 可 以 了 ， 如 下 所 示 : 


<androidx,.coordinatorLayout .widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.core.widget.NestedScrollView 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 
</LinearLayout> 


</androidx.core.widget.NestedScrollView> 


</androidx.coordinatorlayout .widget.CoordinatorLayout> 


这 里 我 们 髓 套 了 一 个 和 搂 直 方向 的 LinearLayout , 并 将 Layout _width 设 置 为 
match parent , 将 Layout_height 设 置 为 wrap_content。 


接 下 来 在 LinearLayout 中 放 入 具体 的 内 容 ， 这 里 我 准备 使 用 一 个 TextView 来 显示 水 果 的 内 容 详 
情 ,并 将 TextView 放 在 一 个 卡片 式 布局 当中 ， 如 下 所 示 : 


<androidx.coordinatorlayout.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.core.widget.NestedScrollView 
android:layout width="match parent" 
android:layout height="match parent" 
app:layout behavior="@string/appbar scrolling view behavior"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
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android:layout height="wrap content"> 


<com.google.android.material.card.MaterialCardView 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginBottom="15dp" 
android:layout marginLeft="15dp" 
android:Layout marginRight="15dp" 
android:layout marginTop="35dp" 
app:cardCornerRadius="4dp"> 


<TextView 
android:id="@+id/fruitContentText" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout margin="1l0dp" /> 
</com.google.android.material.card.MaterialCardView> 
</LinearLayout> 


</androidx.core.widget.NestedScrollView> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


这 段 代码 也 没有 什么 难 理解 的 地 方 ， 都 是 我 们 学 过 的 知识 。 需 要 注意 的 是 ， 这 里 为 了 让 界面 更 
加 美观 ， 我 在 MaterialCardView 和 TextView 上 都 加 了 一 些 边 距 。 其 中 ,MaterialCardView 
的 marginTop 加 了 35 dp 的 边 距 ,这 是 为 下 面 要 编写 的 东西 留 出 空间 。 


好 的 ， 这 样 就 把 水 果 标 题 栏 和 水 果 内 容 详 情 的 界面 都 编写 完了 ， 不 过 我 们 还 可 以 在 界面 上 再 添 
加 一 个 悬浮 按钮 。 这 个 悬浮 按钮 并 不 是 必需 的 ， 根 据 具体 的 需求 添加 就 可 以 了 ， 如 果 加 入 的 
话 ， 我 们 将 获得 一 些 额 外 的 动画 效果 。 


为 了 做 出 示范 ， 我 就 准备 在 activity _ fruit.xml 中 加 入 一 个 悬浮 按钮 了 。 这 个 界面 是 一 个 水 果 详 
情 展 示 界 面 ， 那 么 我 就 加 入 一 个 表示 评论 作用 的 悬浮 按钮 吧 。 首 先 需 要 提前 准备 好 一 个 图 标 ， 
这 里 我 放置 了 一 张 ic_comment.png 到 drawable-xxhdpi 目 录 下 。 然 后 修改 

activity fruit.xml 中 的 代码 ， 如 下 所 示 : 


<androidx.coordinatorlayout.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent"> 


<com.google.android.material .appbar.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp"> 


</com.google.android.material.appbar.AppBarLayout> 
<androidx.core.widget.NestedScrollView 

android:layout width="match parent" 

android:layout height="match parent" 

app:layout behavior="@string/appbar scrolling view behavior"> 
</androidx.core.widget.NestedScrollView> 


<com.google.android.material.floatingactionbutton.FloatingActionButton 
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android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout margin="16dp" 
android:src="@drawable/ic comment" 
app:layout anchor="@id/appBar" 
app:Layout anchorGravity="bottom|end” /> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


可 以 看 到 ， 这 里 加 入 了 一 个 FloatingActionButton , 它 和 AppBarLayout 以 及 
NestedScrollView 是 平 级 的 。FloatingActionButton 中 使 用 app:Layout_anchor 属 性 指定 
了 一 个 锚 点 ,我们 将 锚 点 设置 为 AppBarLayout ,这 样 悬 浮 按钮 就 会 出 现在 水 果 标 题 栏 的 区 域 
内 ,接着 又 使 用 app :Layout_anchorGravity 属 性 将 悬浮 按钮 定位 在 标题 栏 区 域 的 右 下 角 。 
其 他 一 些 属 性 比较 简单 ， 就 不 再 进行 解释 了 。 


好 了 “， 现 在 我 们 终于 将 整个 activity_fruit.xml 布 局 都 编写 完了 ， 内 容 虽 然 比 较 长 ， 但 由 于 是 分 
段 编 写 的 ， 并 且 每 一 步 我 都 进行 了 详细 的 说 明 ， 相 信 你 应 该 看 得 很 明白 吧 。 


界面 完成 了 之 后 ， 接 下 来 我 们 开始 编写 功能 逻辑 ， 修 改 FruitActivity 中 的 代码 ， 如 下 所 示 : 


class FruitActivity : AppCompatActivity() { 


companion object { 

const val FRUIT NAME = "fruit name" 

const val FRUIT IMAGE ID = "fruit image id" 
} 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
SetContentView(R.Layout ,activity fruit) 
val fruitName = intent.getStringExtra(FRUIT NAME) ?: "" 
val fruitImageld = intent.getIntExtra(FRUIT IMAGE ID, 0) 
setSupportActionBar (toolbar) 
supportActionBar?.setDisplayHomeAsUpEnabled(true) 
collapsingToolbar.title = fruitName 
GLide.with(this).Load(fruitImageId) .into(fruitImageView) 
fruitContentText .text = generateFruitContent (fruitName) 


} 


override fun onOptionsItemSelected(item: MenuItem): Boolean { 
when (item.itemId) { 
android.R.id.home -> { 
finish() 
return true 
} 
} 


return super.onOptionsItemSelected(item) 


} 


private fun generateFruitContent(fruitName: String) = fruitName.repeat(500) 


} 


FruitActivity 中 的 代码 并 不 是 很 复杂 。 首 先 ，, 在 onCreate ( ) 方 法 中 ,我 们 通过 Intent 获 取 了 
传 入 的 水 果 名 和 水 果 图 片 的 资源 jd。 接着 使 用 了 Toolbar 的 标准 用 法 ,将 它 作 为 ActionBar 显 
示 ， 并 启用 Home 按 钮 。 由 于 Home 按 钮 的 默认 图 标 就 是 一 个 返回 箭头 ， 这 正 是 我 们 所 期 望 的 ， 
因此 就 不 用 额外 设置 别 的 图 标 了 。 
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接 下 来 开始 填充 界面 上 的 内 容 ， 调 用 CollapsingToolbarLayout 的 setTittLe() 方 法 ,将 水 果 
名 设置 成 当前 界面 的 标题 ， 然 后 使 用 Glide 加 载 传 入 的 水 果 图 片 ， 并 设置 到 标题 栏 的 
ImageView 上 面 。 接 着 需要 填充 水 果 的 内 容 详情 ,由 于 这 只 是 一 个 示例 程序 ,并 不 需要 什么 真 
实 的 数据 ， 所 以 我 使 用 了 一 个 generateFruitContent ( ) 方 法 将 水 果 名 循环 拼接 500 次 ， 从 
而 生成 了 一 个 比较 长 的 字符 串 ， 将 它 设 置 到 了 TextView 上 面 。 


最 后 ， 我 们 在 on0ptionsItemSetLected () 方 法 中 处 理 了 Home 按 钮 的 点 击 事件 , 当 点 击 这 个 
按钮 时 ， 就 调用 finish () 方 法 关闭 当前 的 Activity ,从 而 返回 上 一 个 Activity。 


所 有 工作 都 完成 了 吗 ? 其 实 还 差 最 关键 的 一 步 ， 就 是 处 理 RecyclerView 的 点 击 事 件 ， 不 然 的 
话 ， 我 们 根本 就 无 法 打开 FruitActivity。 修 改 FruitAdapter 中 的 代码 ， 如 下 所 示 : 


class FruitAdapter(val context: Context, val fruitList: List<Fruit>) : 
RecyclerView.Adapter<FruitAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInfLater.from(context).infLate(R.Layout.fruit item, parent, false) 
val holder = ViewHolder(view) 
holder.itemView.setOnClickListener { 
val position = holder.adapterPosition 
val fruit = fruitList[position] 
val intent = Intent(context, FruitActivity::class.java).apply { 
putExtra(FruitActivity.FRUIT NAME, fruit.name) 
putExtra(FruitActivity.FRUIT IMAGE ID, fruit.imageld) 
} 


context.startActivity(intent) 


return holder 


} 


最 关键 的 一 步 其 实 也 是 最 简单 的 ， 这 里 我 们 给 fruit_item.xml 的 最 外 层 布 局 注册 了 一 个 点 击 事 
件 监听 器 ， 然 后 在 点 击 事件 中 获取 当前 点 击 项 的 水 果 名 和 水 果 图 片 资 源 id， 把 它们 传 入 Intent 
中 ,最 后 调用 startActivity() 方 法 启动 FruitActivity，。 


见证 奇迹 的 时 刻 到 了 ， 现 在 重新 运行 一 下 程序 ， 并 点 击 界面 上 的 任意 一 个 水 果 ， 比如 我 点 击 了 
葡萄 ， 效 果 如 图 12.17 所 示 。 
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图 12.17 水 果 的 详情 展示 界面 


你 没有 看 错 , 如 此 精美 的 界面 就 是 我 们 亲手 敲 出 来 的 。 个 界面 上 的 内 容 分 为 3 部 分 : 水 果 标 题 
栏 、 水 果 内 容 详情 和 悬浮 按钮 。 相 信 你 一 腿 就 外 多 它们 区 分 出 来 Toolbar 和 水 果 背 景 图 完美 
地 融合 到 了 一 起 ， 既 保证 了 图 片 的 展示 空 间 ， 又 不 影响 Toolbar 的 任何 功能 ， 那 个 向 左 的 箭头 就 
是 用 来 返回 上 一 个 Activity 的 。 


过 这 并 不 是 全 部 ， 真 正 的 好 戏 还 在 后 头 。 我 们 尝试 向 上 拖 动 水 果 内 容 详情 ， 你 会 发 现 水 果 青 
景 图 上 的 标题 会 慢 慢 缩小 ,并且 背景 图 会 产生 一 些 错位 偏 移 的 效果 ,如 图 12. 18 所 示 。 
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图 12.18 向 上 拖 动 水 果 内 容 详 情 


这 是 由 于 用 户 想 要 查看 水 果 的 内 容 详情 ， 此 时 界面 的 重点 在 具体 的 内 容 上 面 ， 因 此 标题 栏 就 会 
自动 进行 折 营 ， 从 而 节省 屏幕 空间 。 


继续 向 上 拖 动 ， 直 到 标题 栏 变 成 完全 折 革 状态 ,效果 如 图 12.19 所 示 。 
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图 12.19 标题 栏 变 成 完全 折 香 状态 


可 以 看 到 ， 标 题 栏 的 背景 图 片 不 见 了 ， 晤 浮 按钮 也 自动 消失 了 ， 现 在 水 果 标 题 栏 变 成 了 一 个 最 
普通 的 Toolbar。 这 是 由 于 用 户 正 在 阅读 具体 的 内 容 ， 我 们 需要 给 他 们 提供 最 充分 的 阅读 空间 。 
而 如 果 这 个 时 候 向 下 拖 动 水 果 内 容 详 情 ， 就 会 执行 一 个 完全 相反 的 动画 过 程 ， 最终 恢复 成 图 
12.17 的 界面 效果 。 


不 知道 你 有 没有 被 这 个 效果 所 感动 呢 ? 在 这 里 ， 我 真心 地 感谢 Material 库 给 我 们 带 来 这 么 棒 的 
UI 体验 。 


12.7.2 充分 利用 系统 状态 栏 空间 


虽说 现在 水 果 详 情 展示 界面 的 效果 已 经 非常 华丽 了 ， 但 这 并 不 代表 我 们 不 能 再 进一步 地 提升 。 
观察 一 下 图 12.17， 你 会 发 现 水 果 的 背景 图 片 和 系统 的 状态 栏 总 有 一 些 不 搭 的 感觉 ,如果 我 们 能 
将 背景 图 和 状态 栏 融合 到 一 起 ， 那 这 个 视觉 体验 绝对 能 提升 好 几 个 档次 。 
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不 过 , 在 Android 5.0 系 统 之 前 ， 我 们 是 无 法 对 状态 栏 的 背景 或 颜色 进行 操作 的 ， 那 个 时 候 也 还 
没有 Material Design 的 概念 ， 但 是 Android 5.0 及 之 后 的 系统 都 是 支持 这 个 功能 的 。 恰 好 我 们 
整 本 书 的 所 有 代码 最 低 兼 容 的 就 是 Android 5.0 系 统 ,因此 这 里 完全 可 以 进一步 地 提升 视觉 体 


JYo 


想 要 让 背景 图 能 够 和 系统 状态 栏 融 合 ， 需要 借助 android:fitsSystemWindows 这 个 属性 来 

实现 。 在 CoordinatorLayout、AppBarLayout、CollapsingToolbarLayout 这 种 藤 套 结构 的 
布局 中 ， 将 控件 的 android:fitsSystemWindows 属 性 指定 成 true， 就 表示 该 控件 会 出 现在 
系统 状态 栏 里 。 对 应 到 我 们 的 程序 ， 那 就 是 水 果 标 题 栏 中 的 ImageView 应 该 设置 这 个 属性 了 。 

不 过 只 给 ImageView 设 置 这 个 属性 是 没有 用 的 ， 我 们 必须 将 ImageView 布 局 结构 中 的 所 有 父 

布局 都 设置 上 这 个 属性 才 可 以 ,修改 activity_fruit.xml 中 的 代码 , 如 下 所 示 : 


<androidx,.coordinatorLayout .widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="match parent" 
android:fitsSystemWindows="true"> 


<com.google.android.material.appbar.AppBarLayout 
android:id="@+id/appBar" 
android:layout width="match parent" 
android:layout height="250dp" 
android:fitsSystemWindows="true"> 


<com.google.android.material.appbar.CollapsingToolbarLayout 
android:id="@+id/collapsingToolbar" 
android:layout width="match parent" 
android:layout height="match parent" 
android:theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar" 
android:fitsSystemWindows="true" 
app:contentScrim="@color/colorPrimary" 
app:Layout scrollFlags="scroll|exitUntilCollapsed"> 


<ImageView 
android:id="@+id/fruitImageView" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
android:fitsSystemWindows="true" 
app:layout collapseMode="parallax" /> 


</com.google.android.material.appbar.CollapsingToolbarLayout> 
</com.google.android.material.appbar.AppBarLayout> 


</androidx.coordinatorlayout.widget.CoordinatorLayout> 


但 是 ,即使 我 们 将 android:fitsSystemWindows 属 性 都 设置 好 了 也 没有 用 ， 因为 还 必须 在 
程序 的 主题 中 将 状态 栏 颜色 指定 成 透明 色 才 行 。 指 定 成 透明 色 的 方法 很 简单 ， 在 主题 中 将 
android:statusBarColor 属 性 的 值 指定 成 Gandroid:color/transparent 就 可 以 了 。 


打开 res/values/styles.xm|I 文 件 , 对 主题 的 内 容 进 行 修改 ， 如 下 所 示 : 


<resources> 


<!-- Base application theme. --> 
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<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<!-- Customize your theme here. --> 
<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


<style name="FruitActivityTheme" parent="AppTheme"> 
<item name="android:statusBarColor">@android:color/transparent</item> 
</style> 


</resources> 


这 里 我 们 定义 了 一 个 FruitActivityTheme 主 题 ， 它 是 专门 给 FruitActivity 使 用 的 。 
FruitActivityTheme 的 父 主题 是 AppTheme ,也 就 是 说 ， 它 继承 了 AppTheme 中 的 所 有 特 
性 。 在 此 基础 之 上 ， 我们 将 FruitActivityTheme 中 的 状态 栏 的 颜色 指定 成 透明 色 。 


最 后 ， 还 需要 让 FruitActivity 使 用 这 个 主题 才 可 以 ， 修 改 AndroidManifest.xml 中 的 代码 ， 如 
下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.materialtest"> 


<application 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


<activity 
android:name=" .FruitActivity" 
android:theme="@style/FruitActivityTheme"> 
</activity> 
</application> 


</manifest> 


CY 


这 里 使 用 android :theme 属 性 单独 给 FruitActivity 指 定 了 FruitActivityTheme 这 个 主题 ， 这 
样 我 们 就 大 功 告 成 了 。 现 在 重新 运行 MaterialTest 程 序 ， 水 果 详 情 展示 界面 的 效果 就 会 如 图 
12.20 所 示 。 
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图 12.20 ”背景 图 和 状态 栏 融合 的 效果 
相信 我 ， 再 对 比 一 下 图 12.17 的 效果 ,这 两 种 视觉 体验 绝对 不 是 在 一 个 档次 上 的 。 


好 了 ,关于 Material Design 的 知识 我 们 就 学 到 这 里 ， 接 下 来 又 该 进入 本 章 的 Kotlin 课 堂 了 ， 赶 
快 看 一 看 这 次 又 能 学 到 Kotlin 的 什么 新 知识 吧 。 
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12.8 Kotlin 课 堂 : 编写 好 用 的 工具 方法 


到 目前 为 止 ， 我 们 已 经 将 Kotlin 大 部 分 系统 性 的 知识 点 学 习 完 了 。 掌 握 了 如 此 多 的 Kotlin 特 性 ， 
你 知道 该 如 何 对 它们 进行 灵活 运用 吗 ? 


事实 上 ，Kotlin 提 供 的 丰 语 语法 特性 给 我 们 提供 了 无 限 扩展 的 可 能 ， 各 种 复杂 的 API 经 过 特殊 的 
封装 处 理 之 后 都 能 变 得 简单 易 用 。 比 如 我 们 之 前 在 第 7 章 体验 过 的 KTX 库 ， 就 是 Google 为 了 简 

化 许多 API 的 用 法 而 专门 设计 的 。 不 过 KTX 库 所 能 覆盖 到 的 功能 毕竟 有 限 ， 因 此 最 重要 的 还 是 我 
们 要 能 养 成 对 Kotlin 的 各 种 特性 进行 灵活 运用 的 意识 。 那 么 在 本 节 的 Kotlin 课 堂 中 ， 我 将 带 你 对 
几 个 常用 API 的 用 法 进行 简化 ， 从 而 编写 出 一 些 好 用 的 工具 方法 。 


12.8.1 求 NW 个 数 的 最 大 最 小 值 


两 个 数 比 大 小 这 个 功能 ， 相 信 每 一 位 开发 者 都 遇 到 过 。 如 果 我 想 要 获取 两 个 数 中 较 大 的 那个 
数 ， 除 了 使 用 最 基本 的 if 语 句 之 外 ， 还 可 以 借助 Kotlin 内 置 的 max( ) 泌 数 ， 如 下 所 示 : 
val a = 10 


val b = 15 
val larger = max(a, b) 


这 种 代码 看 上 去 简单 直观 ， 也 很 容易 理解 ， 因 此 好 像 并 没有 什么 优化 的 必要 。 


可 是 现在 如 果 我 们 想 要 在 3 个 数 中 获取 最 大 的 那个 数 ， 应 该 怎么 写 呢 ? 由 于 max ( ) 函数 只 能 接收 
两 个 参数 ， 因 此 需要 先 比较 前 两 个 数 的 大 小 ， 然 后 再 拿 较 大 的 那个 数 和 剩余 的 数 进 行 比较 ， 写 
法 如 下 : 


val a = 10 
val b = 15 
vaL C = 5 


val Largest = max(max(a, b), c) 


有 没有 觉得 代码 开始 变 得 复杂 了 呢 ? 3 个 数 中 获取 最 大 值 就 需要 使 用 这 种 网 套 max ( ) 也 数 的 写法 
了 ， 那 如 果 是 4 个 数 、5 个 数 呢 ? 没 错 ， 这 个 时 候 你 就 应 该 意识 到 ,我 们 是 可 以 对 max ( ) 活 数 的 
用 法 进行 简化 的 。 


回顾 一 下 ， 我 们 之 前 在 第 7 章 的 Kotlin 课 堂 中 学 过 va rarg 关 键 字 , 它 人 允许 方法 接收 任意 多 个 同 
等 类 型 的 参数 ， 正 好 满足 我 们 这 里 的 需求 。 那 么 我 们 就 可 以 新 建 一 个 Max.kt 文 件 ， 并 在 其 中 自 
定义 一 个 max() 了 水 数 ， 如 下 所 示 : 


fun max(vararg nums: Int): Int { 
var maxNum = Int.MIN VALUE 
for (num in nums) { 
maxNum = kotlin.math.max(maxNum, num) 
} 


return maxNum 
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可 以 看 到 ， 这 里 max ( ) 函数 的 参数 声明 中 使 用 了 vararg 关 键 字 ,也 就 是 说 现在 它 可 以 接收 任意 
多 个 整 型 参数 。 接 着 我 们 使 用 了 一 个 mnaxNum 变 量 来 记录 所 有 数 的 最 大 值 ， 并 在 一 开始 将 它 赋 值 
成 了 整 型 范围 的 最 小 值 。 然 后 使 用 for- in 循环 遍历 nums 参 数列 表 ， 如 果 发 现 当 前 遍历 的 数字 
比 maxNum 更 大 ， 就 将 naxNum 的 值 更 新 成 这 个 数 ， 最终 将 maxNum 返 回 即 可 。 


仅仅 经 过 这 样 的 一 层 封装 之 后 ， 我 们 在 使 用 max ( ) 函数 时 就 会 有 翻天 覆 地 的 变化 ， 比 如 刚才 同 
样 的 功能 ， 现 在 就 可 以 使 用 如 下 的 写法 来 实现 : 


val a = 10 
val b = 15 
val C = 5 


val Largest = max(a, b, c) 


这 样 我 们 就 彻底 摆脱 了 艇 套 函 数 调用 的 写法 ， 现 在 不 管 是 求 3 个 数 的 最 大 值 还 是 求 W 个 数 的 最 大 
值 , 只 需要 不 断 地 给 max( ) 函数 传 入 参数 就 可 以 了 。 


不 过 ,目前 我 们 自 定义 的 max( ) 函数 还 有 一 个 缺点 ， 就 是 它 只 能 求 W 个 整 型 数字 的 最 大 值 ， 如 果 
我 还 想 求 A 个 浮 点 型 或 长 整 型 数字 的 最 大 值 ， 该 怎么 办 呢 ? 当然 你 可 以 定义 很 多 个 max ( ) 函数 的 
重 载 ， 来 接收 不 同类 型 的 参数 ， 因 为 Kotlin 中 内 置 的 max ( ) 函数 也 是 这 么 做 的 。 但 是 这 种 方案 实 
现 起 来 过 于 烦琐 ， 而 且 还 会 产生 大 量 的 重复 代码 ， 因 此 这 里 我 准备 使 用 一 种 更 加 巧妙 的 做 法 。 


Java 中 规定 ， 所 有 类 型 的 数字 都 是 可 比较 的 ， 因 此 必须 实现 Comparable 接 口 ， 这 个 规则 在 
Kotlin 中 也 同样 成 立 。 那 么 我 们 就 可 以 借助 泛 型 ， 将 max ( ) 函数 修改 成 接收 任意 多 个 实现 
Comparable 接 口 的 参数 ， 代 码 如 下 所 示 : 


fun <T : Comparable<T>> max(vararg nums: T): T{ 
if (nums.isEmpty()) throw RuntimeException("Params can not be empty.") 
var maxNum = nums[0] 
for (num in nums) { 
if (num > maxNum) { 
maxNum = num 


return maxNum 


} 


可 以 看 到 ， 这 里 将 泛 型 T 的 上 界 指定 成 了 Comparable<T> ,那么 参数 T 就 必然 是 
Comparable<T> 的 子 类 型 了 。 接 下 来 ， 我 们 判断 nums 参 数列 表 是 否 为 空 ， 如 果 为 空 的 话 就 主 
动 抛 出 一 个 异常 ， 提 醒 调用 者 max ( ) 函数 必须 传 入 参数 。 紧 接着 将 maxNum 的 值 赋值 成 nums 参 
数列 表 中 第 一 个 参数 的 值 ， 然 后 同样 是 遍历 参数 列表 , 如果 发 现 了 更 大 的 值 就 对 maxNum 进 行 更 
新 。 


经 过 这 样 的 修改 之 后 ， 我 们 就 可 以 更 加 灵活 地 使 用 max ( ) 函数 了 ， 比 如 说 求 3 个 浮 点 型 数字 的 最 
大 值 ,同样 也 变 得 轻而易举 : 
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而 且 现在 不 管 是 双 精 度 浮 点 型 、 单 精度 浮 点 型 ， 还 是 短 整 型 、 整 型 、 长 整 型 ， 只 要 是 实现 
Comparable 接 口 的 子 类 型 ，max( ) 函数 全 部 支持 获取 它们 的 最 大 值 ， 是 一 种 一 劳 永 逸 的 做 
法 。 


而 如 果 你 想 获取 人 个 数 的 最 小 值 ， 实 现 的 方式 也 是 类 似 的 ， 只 需要 定义 一 个 min ( ) 函数 就 可 以 
了 ,这 个 功能 就 当 作 课 后 习题 留 给 你 来 完成 吧 。 


12.8.2 简化 Toast 的 用 法 


我 们 在 本 书 中 已 经 使 用 过 太 多 次 Toast , 相信 你 已 经 非常 熟悉 了 ,但 是 用 了 这 么 久 ， 你 有 没有 觉 
得 Toast 用 法 其 实 有 些 烦 瑞 呢 ? 


首先 回顾 一 下 Toast 的 标准 用 法 吧 ， 如 果 想 要 在 界面 上 弹出 一 段 文字 提示 需要 这 样 写 : 


Toast.makeText(context, "This is Toast", Toast.LENGTH SHORT) .show() 


是 不 是 很 长 的 一 段 代 码 ? 而 且 曾 经 不 知道 有 多 少 人 因为 忘记 调用 最 后 的 show( ) 方 法 ， 导致 
Toast 无 法 弹出 ， 从 而 产生 一 些 干 奇 百 怪 的 bug。 


由 于 Toast 是 非常 常用 的 功能 , 每 次 都 需要 编写 这 么 长 的 一 段 代码 确实 让 人 很 头疼 ， 这 个 时 候 你 
就 应 该 考虑 对 Toast 的 用 法 进行 简化 了 。 


我 们 来 分 析 一 下 ，Toast 的 makeText ( ) 方 法 接收 3 个 参数 : 第 一 个 参数 是 Toast 显 示 的 上 下 文 环 
境 ， 必 不 可 少 ; 第 二 个 参数 是 Toast 显 示 的 内 容 ， 需 要 由 调用 方 进 行 指定 ， 可 以 传 入 字符 串 和 字 
符 串 资源 id 两 种 类 型 ; 第 三 个 参数 是 Toast 显 示 的 时 长 ， 只 支持 Toast .LENGTH_SHORT 和 
Toast .LENGTH_LONG 这 两 种 值 ， 相 对 来 说 变化 不 大 。 


那么 我 们 就 可 以 给 String 类 和 Int 类 各 添加 一 个 扩展 水 数 ， 并 在 里 面 封装 弹出 Toast 的 具体 逻 
辑 。 这 样 以 后 每 次 想 要 弹出 Toast 提 示 时 ， 只 需要 调用 它们 的 扩展 函数 就 可 以 了 。 


新 建 一 个 Toast,kt 文 件 ， 并 在 其 中 编写 如 下 代码 : 


fun String.showToast(context: Context) { 
Toast.makeText(context, this, Toast.LENGTH SHORT).show() 


fun Int.showToast(context: Context) { 
Toast.makeText(context, this, Toast.LENGTH SHORT).show() 
} 


这 里 分 别 给 String 类 和 Int 类 新 增 了 一 个 showToast ( ) 函数 ， 并 让 它们 都 接收 一 个 Context 
参数 。 然 后 在 函数 的 内 部 ， 我 们 仍然 使 用 了 Toast 原 生 API 用 法 ， 只 是 将 弹出 的 内 容 改 成 了 
this ,另外 将 Toast 的 显示 时 长 固定 设置 成 Toast .LENGTH SHORT。 


那么 经 过 这 样 的 扩展 之 后 ， 我 们 以 后 在 使 用 Toast 时 可 以 变 得 多 人 么 简单 呢 ? 体验 一 下 就 知道 了 ， 
比如 同样 弹出 一 段 文 字 提 醒 就 可 以 这 么 写 : 


"This is Toast".showToast(context) 
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怎么 样 ， 比 起 原生 Toast 的 用 法 ， 有 没有 觉得 这 种 写法 畅快 多 了 呢 ? 另外 , 这 只 是 直接 弹出 一 段 
字符 串 文 本 的 写法 ， 如 果 你 想 弹 出 一 个 定义 在 strings.xml 中 的 字符 串 资 源 ， 也 非常 简单 ， 写 法 
如 下 : 


R.string.app_name.SshowToast(context) 


这 两 种 与 法 分 别 调用 的 就 是 我 们 刚才 在 St ring 类 和 Int 类 中 添加 的 showToast ( ) 扩 展 函 数 。 


当然 ， 这 种 写法 其 实 还 存在 一 个 问题 ， 就 是 Toast 的 显示 时 长 被 固定 了 ， 如 果 我 现在 想 要 使 用 
Toast .LENGTH_LONG 类 型 的 显示 时 长 该 怎么 办 呢 ? 要 解决 这 个 问题 ， 其 实 最 简单 的 做 法 就 是 
在 ShowToast ( ) 国 数 中 再 声明 一 个 显示 时 长 参数 ,但 是 这 样 每 次 调用 ShowToast ( ) 项 数 时 都 
要 额外 多 传 入 一 个 参数 ， 无 疑 增加 了 使 用 复杂 度 。 


不 知道 你 现在 有 没有 受到 什么 启发 呢 ? 回顾 一 下 ， 我 们 在 第 2 章 学 习 Kotlin 基 础 语法 的 时 候 ， 曾 
经 学 过 给 水 数 设 定 参数 默认 值 的 功能 。 只 要 借助 这 个 功能 ， 我们 就 可 以 在 不 增加 showToast ( ) 
子 数 使 用 复杂 度 的 情况 下 ， 又 让 它 可 以 支持 动态 指定 显示 时 长 了 。 修 改 Toast.kt 中 的 代码 ， 如 下 
所 示 : 


fun String.showToast(context: Context，duration: Int = Toast.LENGTH SHORT) { 
Toast .makeText (context，this，duration) .show() 


fun Int.showToast(context: Context, duration: Int = Toast.LENGTH SHORT) { 
Toast.makeText (context, this, duration).show() 
} 


可 以 看 到 , 我 们 给 showToast ( ) 函数 增加 了 一 个 显示 时 长 参数 ， 但 同时 也 给 它 指定 了 一 个 参数 
默认 值 。 这 样 我 们 之 前 所 使 用 的 ShowToast ( ) 函数 的 写法 将 完全 不 受 影响 ， 默 认 会 使 用 
Toast .LENGTH_SHORT 类 型 的 显示 时 长 。 而 如 果 你 想 要 使 用 Toast .LENGTH_LONG 的 显示 时 
长 ， 只 需要 这 样 写 就 可 以 了 : 


"This is Toast".showToast(context, Toast.LENGTH LONG) 


相信 我 ， 这 样 的 T0ast 工 具 一 定 会 给 你 的 开发 效率 带 来 巨大 的 提升 。 
12.8.3 简化 Snackbar 的 用 法 


Snackbar 是 我 们 在 本 章 中 学 习 的 新 控件 ， 它 和 Tbast 的 用 法 基本 类 似 , 但 是 又 比 Toast 稍 微 复杂 
一 些 . 


先 来 回顾 一 下 Snackbar 的 常规 用 法 吧 ， 如 下 所 示 : 


Snackbar.make(view, "This is Snackbar", Snackbar.LENGTH SHORT ) 
.SetAction("Action") { 
// 处 理 具体 的 逻辑 


.Show() 
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可 以 看 到 ，Snackbar 中 make( ) 方 法 的 第 一 个 参数 变 成 了 View , 而 Toast 中 makeText ( ) 方 法 
的 第 一 个 参数 是 Context ,另外 Snackbar 还 可 以 调用 setAction() 方 法 来 设置 一 个 额外 的 点 
击 事件 。 除 了 这 些 区 别 之 外 ，Snackbar 和 Toast 的 其 他 用 法 都 是 相似 的 。 


那么 对 于 这 种 结构 的 API ,我 们 该 如 何 进行 简化 呢 ? 其 实 简化 的 方式 并 不 固定 ， 接 下 来 我 即将 演 
示 的 写法 也 只 是 我 个 人 认为 比较 不 错 的 一 种 。 


由 于 make ( ) 方 法 接收 一 个 View 参 数 ，Snackbar 会 使 用 这 个 View 自 动 查找 最 外 层 的 布局 ,用 
于 展示 Snackbar。 因 此 ,我 们 就 可 以 给 View 类 添加 一 个 扩展 函数 ， 并 在 里 面 封 装 显示 
Snackbar 的 具体 逻辑 。 新 建 一 个 Snackbar.kt 文 件 ， 并 编写 如 下 代码 : 


fun View.showSnackbar(text: String, duration: Int = Snackbar.LENGTH SHORT) { 
Snackbar.make(this, text, duration).show() 
} 


fun View.showSnackbar(resId: Int, duration: Int = Snackbar.LENGTH SHORT) { 
Snackbar.make(this, resId, duration).show() 
} 


这 上段 代码 应 该 还 是 很 好 理解 的 ， 和 刚才 的 showToast ( ) 函数 比较 相似 。 只 是 我 们 将 扩展 函数 添 
加 到 了 View 类 当中 ， 并 在 参数 列表 上 声明 了 Snackbar 要 显示 的 内 容 以 及 显示 的 时 长 。 另 外 ， 
Snackbar 和 Toast 类 似 ， 显示 的 内 容 也 是 支持 传 入 字符 串 和 字符 串 资源 id 两 种 类 型 的 ， 因 此 这 
里 我 们 给 showSnackbar ( ) 函数 进行 了 两 种 参数 类 型 的 水 数 重 载 。 


现在 想 要 使 用 Snackbar 显 示 一 段 文本 提示 ， 只 需要 这 样 写 就 可 以 了 : 


view.showSnackbar("This is Snackbar") 


假如 Snackbar 没 有 setAction() 方 法 ,那么 我 们 的 简化 工作 到 这 里 就 可 以 结束 了 。 但 是 
setAction() 方 法 作为 Snackbar 最 大 的 特色 之 一 ， 如果 不 能 支持 的 话 ， 我 们 编写 的 
showSnackbar( ) 函数 也 就 变 得 毫 无 意义 了 。 


这 个 时 候 ， 神通 广 大 的 高 阶 函 数 又 能 派 上 用 场 了 ， 我 们 可 以 让 showSnackbar( ) 函 数 再 额外 接 
收 一 个 函数 类 型 参数 ， 以 此 来 实现 Snackbar 的 完整 功能 支持 。 修 改 Snackbarkt 中 的 代码 ,如 
下 所 示 : 


fun View.showSnackbar(text: String, actionText: String? = null, 
duration: Int = Snackbar.LENGTH SHORT, block: (() -> Unit)? = null) { 
val snackbar = Snackbar.make(this, text, duration) 
if (actionText != nuLL && block != nuLL) { 
snackbar.setAction(actionText) { 
block() 
} 


snackbar. show() 


fun View.showSnackbar(resId: Int, actionResId: Int? = null, 
duration: Int = Snackbar.LENGTH SHORT, block: (() -> Unit)? = null) { 
val snackbar = Snackbar.make(this, resId, duration) 
if (actionResId != null && block != nuLL) { 
snackbar.setAction(actionResId) { 
block() 
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} 


snackbar. show() 


可 以 看 到 ， 这 里 我 们 给 两 个 showSnackbar ( ) 函数 都 增加 了 一 个 函数 类 型 参数 ， 并 且 还 增加 了 
一 个 用 于 传递 给 setAction( ) 方 法 的 字符 串 或 字符 串 资 源 id。 这 里 我 们 需要 将 新 增 的 两 个 参数 
都 设置 成 可 为 空 的 类 型 ， 并 将 默认 值 都 设置 成 空 ， 然 后 只 有 当 两 个 参数 都 不 为 空 的 时 候 ， 我 们 
才 去 调用 Snackbar 的 setAction( ) 方 法 来 设置 额外 的 点 击 事 件 。 如 果 触 发 了 点 击 事件 ,只 需 
要 调用 函数 类 型 参数 将 事件 传递 给 外 部 的 Lambda 表 达 式 即 可 。 


这 样 showSnackbar () 函 数 就 拥有 比较 完整 的 Snackbar 功 能 了 ， 比 如 本 小 节 最 开始 的 那 段 示 
例 代 码 ， 现 在 就 可 以 使 用 如 下 写法 进行 实现 : 


view.showSnackbar("This is Snackbar", "Action") { 
// 处 理 具体 的 逻辑 


} 


怎么 样 ,和 Snackbar 原 生 API 的 用 法 相 比 ， 我 们 编写 的 ShowSnackbar ( ) 噬 数 是 不 是 要 明显 简 
单 好 用 得 多 ? 


在 本 章 的 Kotlin 课 党 中 ， 我 带 着 你 一 共 编 写 了 3 个 工具 方法 ， 分 别 应 用 了 顶层 函数 、 扩 展 函 数 以 
及 高 阶 函数 的 知识 ， 当 然 还 用 到 了 像 vararg、 参 数 默 认 值 等 技巧 。Kotlin 给 我 们 提供 了 太 多 出 
色 的 特性 ， 因 此 在 你 学 完了 这 么 多 特性 之 后 ， 能 否 将 它们 灵活 运用 就 成 为 了 至 关 重 要 的 事情 。 
本 节 课 里 所 实现 的 3 个 工具 方法 只 能 算是 开胃 菜 ， 我 非常 期 待 未 来 你 能 编写 出 许多 自己 的 工具 方 
法 ,将 Kotlin 提 供给 我 们 的 优秀 特性 充分 发 挥 出 来 。 


好 了 ， 关 于 Kotlin 的 内 容 就 先 讲 到 这 里 ， 下 面 我 们 将 再 次 进入 本 书 的 特殊 环节 一 一 Git 时 间 ,学 
习 一 下 关于 Git 的 高 级 用 法 。 
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12.9 Git 时间 : 版 本 控制 工具 的 高 级 用 法 


现在 的 你 对 于 Git 应 该 完全 不 会 感到 陌生 了 吧 ? 通过 之 前 两 次 Git 时 间 的 学 习 ， 你 已 经 掌握 了 很 多 
Git 中 常用 的 命令 ， 像 提交 代码 这 种 简单 的 操作 相信 肯定 是 难 不 倒 你 的 。 


打开 终端 界面 , 进入 MaterialTest 这 个 项 目的 根 目录 , 然后 执行 提交 操作 : 


git init 
git add . 
git commit ~m "First Commit." 


这 样 就 将 准备 工作 完成 了 ， 下 面 就 让 我 们 开始 学 习 关 于 Git 的 高 级 用 法 。 
12.9.1 分 支 的 用 法 


分 支 是 版 本 控制 工具 中 比较 高 级 且 比 较 重 要 的 一 个 概念 ， 它 主要 的 作用 就 是 在 现 有 代码 的 基础 
上 开辟 一 个 分 叉 口 ， 使 得 代码 可 以 在 主干 线 和 分 支线 上 同时 进行 开发 ， 且 相互 之 间 不 会 影响 。 
分 支 的 工作 原理 如 图 12.21 所 示 。 


主干 线 


表示 一 次 提交 
图 12.21 分 支 的 工作 原理 示意 图 


你 也 许 会 有 疑惑 ,为 什么 需要 建立 分 支 呢 ? 只 在 主干 线 上 进行 开发 不 是 挺 好 的 吗 ? 没 错 ， 通 常 
情况 下 ,只 在 主干 线 上 进行 开发 是 完全 没有 问题 的 。 不 过 ， 一 旦 涉及 发 布 版 本 的 情况 ， 如 果 不 
建立 分 支 的 话 ， 你 就 会 非常 地 头疼 。 举 个 简单 的 例子 吧 ， 比 如 说 你 们 公司 研发 了 一 款 不 错 的 软 
件 ， 最近 刚刚 完成 ， 并 推出 了 1.0 版 本 。 但 是 领导 是 不 会 让 你 们 闲 着 的 ， 马 上 提出 了 新 的 需求 ， 
让 你 们 投入 到 1.1 版 本 的 开发 工作 当中 。 过 了 几 个 星期 ，1.1 版 本 的 功能 已 经 完成 了 一 半 ， 但 是 
这 个 时 候 突然 有 用 户 反馈 ， 之 前 上 线 的 1.0 版 本 发 现 了 几 个 重大 的 bug ,严重 影响 软件 的 正常 使 
用 。 领 导 也 相当 重视 这 个 问题 ， 要求 你 们 立刻 修复 这 些 bug， 并 对 1.0 版 本 进行 更 新 ， 但 这 个 时 
候 你 就 非常 为 难 了 ， 你 会 发 现 根本 没 法 去 修复 。 因 为 现在 1.1 版 本 已 经 开发 一 半 了 ， 如 果 在 现 有 
代码 的 基础 上 修复 这 些 bug ， 那么 更 新 的 1.0 版 本 将 会 带 有 一 半 1.1 版 本 的 功能 ! 


进退 两 难 了 是 不 是 ? 但 是 如 果 你 使 用 了 分 支 的 话 ， 就 完全 不 会 存在 这 个 让 人 头疼 的 问题 。 你 只 
需要 在 发 布 1.0 版 本 的 时 候 建立 一 个 分 支 ， 然 后 在 主干 线 上 继续 开发 1.1 版 本 的 功能 。 当 在 1.0 版 
本 上 发 现任 何 bug 的 时 候 ， 就 在 分 支线 上 进行 修改 ， 然 后 发 布 新 的 1.0 版 本 ， 并 记得 将 修改 后 的 
代码 合并 到 主干 线 上 。 这 样 的 话 ， 不 仅 可 以 轻松 解决 1.0 版 本 存在 的 bug ， 而 且 保证 了 主干 线 上 
的 代码 也 已 经 修复 了 这 些 bug ， 当 1.1 版 本 发 布 时 ， 就 不 会 有 同样 的 bug 存 在 了 。 


说 了 这 么 多 ， 相信 你 也 已 经 意识 到 分 支 的 重要 性 了 ， 那 么 我 们 马上 来 学 习 一 下 如 何在 Git 中 操作 
分 支 吧 。 


www.blogss.cn 


分 支 的 英文 是 branch , 如 果 想 要 查看 当前 的 版 本 库 当 中 有 哪些 分 支 ， 可 以 使 用 git branch 这 
个 命令 ,结果 如 图 12.22 所 示 。 


guolindeMacBook-Pro:MaterialTest guolin$ git branch 


guolindeMacBook-Pro:MaterialTest guolin$ 


图 12.22 查看 所 有 分 支 


由 于 目前 MaterialTest 项 目 中 还 没有 创建 过 任何 分 支 ， 因 此 只 有 一 个 master 分 支 存在 ,这 也 就 
是 前 面 所 说 的 主干 线 。 接 下 来 我 们 尝试 创建 一 个 分 支 ， 命 令 如 下 : 


git branch version1.0 


这 样 就 创建 了 一 个 名 为 version1.0 的 分 支 ， 我 们 再 次 输入 git branch 这 个 命令 来 检查 一 下 ， 
结果 如 图 12.23 所 示 。 


guolindeMacBook-Pro:MaterialTest guolin$ git branch 
六 


version1.0 
guolindeMacBook-Pro:MaterialTest guolin$ 


图 12.23 再 次 查看 所 有 分 支 


可 以 看 到 ,果然 有 一 个 叫 作 version1.0 的 分 支出 现 了 。 你 会 发 现 ，master 分 支 的 前 面 有 一 
个 “*”" 号 ， 说明 目前 我 们 的 代码 还 是 在 master 分 支 上 的 ， 那 么 怎样 才能 切换 到 version1.0 这 个 
分 支 上 呢 ? 其 实 也 很 简单 ， 只 需要 使 用 checkout 命 令 即 可 ， 如 下 所 示 : 


git checkout version1.0 


再 次 输入 git branch 来 进行 检查 ， 结果 如 图 12.24 所 示 。 


guolindeMacBook-Pro:MaterialTest guolin$ git branch 


master 
3 


guolindeMacBook-Pro:MaterialTest guolin$ 


图 12.24 ”查看 切换 分 支 后 的 结果 
可 以 看 到 ,我们 已 经 把 代码 成 功 切换 到 version1.0 这 个 分 支 上 了 。 


需要 注意 的 是 ， 在 version1.0 分 支 上 修改 并 提交 的 代码 将 不 会 影响 到 master 分 支 。 同 样 的 道 
理 ,在 master 分 支 上 修改 并 提交 的 代码 也 不 会 影响 到 version1.0 分 支 。 因 此 ， 如 果 我 们 在 
version1.0 分 支 上 修复 了 一 个 bug ,在 master 分 支 上 这 个 bug 仍 然 是 存在 的 。 这 时 将 修改 的 代 
码 一 行 行 复制 到 master 分 支 上 显然 不 是 一 种 聪明 的 做 法 ， 最 好 的 办 法 就 是 使 用 me rge 命 令 来 完 
成 合并 操作 ， 如 下 所 示 : 


git checkout master 
git merge version1.0 
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仅仅 使 用 这 样 简单 的 两 行 命令 ,就 可 以 把 在 version1.0 分 支 上 修改 并 提交 的 内 容 合 并 到 master 
分 支 上 了 。 当 然 ， 在 合并 分 支 的 时 候 还 可 能 出 现代 码 冲突 的 情况 ， 这 个 时 候 你 就 需要 静 下 心 
来 ， 慢 慢 解决 这 些 冲 突 ，Git 在 这 里 就 无 法 帮助 你 了 。 


最 后 ， 当 我 们 不 再 需要 Version1.0 这 个 分 支 的 时 候 ， 可 以 使 用 如 下 命令 将 这 个 分 支 删除 : 


git branch -D version1.0 


12.9.2 与 远程 版 本 库 协作 


可 以 这 样 说 ， 如果 你 是 一 个 人 在 开发 ， 那 么 使 用 版 本 控制 工具 就 远 远 无 法 发 挥 出 它 真 正 强大 的 
功能 。 没 错 ， 所 有 版 本 控制 工具 最 重要 的 一 个 特点 就 是 可 以 使 用 它 来 进行 团队 合作 开发 。 每 个 
人 的 电脑 上 都 会 有 一 份 代码 ， 当 团队 的 某 个 成 员 在 自己 的 电脑 上 编写 完成 了 某 个 功能 后 ， 就 将 
代码 提交 到 服务 器 ， 其 他 的 成 员 只 需要 将 服务 器 上 的 代码 同步 到 本 地 ， 就 能 保证 整个 团队 所 有 
人 的 代码 都 相同 。 这 样 的 话 ， 每 个 团队 成 员 就 可 以 各 司 其 职 ， 大 家 共同 来 完成 一 个 较为 庞大 的 
项 目 。 

那么 如 何 使 用 Git 来 进行 团队 合作 开发 呢 ? 这 就 需要 有 一 个 远程 的 版 本 库 ， 团 队 的 每 个 成 员 都 从 
这 个 版 本 库 中 获取 最 原始 的 代码 ， 然 后 各 自 进行 开发 ， 并 且 以 后 每 次 提交 的 代码 都 同步 到 远程 
版 本 库 上 就 可 以 了 。 另 外 ， 团 队 中 的 每 个 成 员 都 要 养 成 经 常 从 版 本 库 中 获取 最 新 代码 的 习惯 ， 
不 然 的 话 ， 大 家 的 代码 就 很 有 可 能 经 常 出 现 冲 突 。 


比如 说 现在 有 一 个 远程 版 本 库 的 Git 地 址 是 https://github.com/example/test.git ,就 可 以 使 
用 如 下 命令 将 代码 下 载 到 本 地 : 


git clone https://github.com/example/test.git 


之 后 如 果 你 在 这 份 代码 的 基础 上 进行 了 一 些 修改 和 提交 ， 那 么 怎样 才能 把 本 地 修改 的 内 容 同 步 
到 远程 版 本 库 上 呢 ? 这 就 需要 借助 push 命 令 来 完成 7， 用 法 如 下 所 示 : 


git push origin master 


origin 部 分 指定 的 是 远程 版 本 库 的 Git 地 址 , master 部 分 指定 的 是 同步 到 哪 一 个 分 支 上 ， 上述 
命令 就 完成 了 将 本 地 代码 同步 到 https://github.com/example/test.git 这 个 版 本 库 的 master 
分 支 上 的 功能 。 


知道 了 将 本 地 的 修改 同步 到 远程 版 本 库 上 的 方法 ， 接 下 来 我 们 看 一 下 如 何 将 远程 版 本 库 上 的 修 
改 同 步 到 本 地 。Git 提 供 了 两 种 命令 来 完成 此 功能 ， 分 别 是 fetch 和 puLL。fetch 的 语法 规则 和 
push 是 差不多 的 ， 如 下 所 未 : 


git fetch origin master 


执行 完 这 个 命令 后 ， 就 会 将 远程 版 本 库 上 的 代码 同步 到 本 地 。 不 过 同步 下 来 的 代码 并 不 会 合 
到 任何 分 支 上 ,而 是 会 存放 到 一 个 origin/master 分 支 上 ， 这 时 我 们 可 以 通过 diff 命 令 来 查 
看 远程 版 本 库 上 到 底 修改 了 哪些 东西 : 


git diff origin/master 
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之 后 再 调用 me rge 命 令 将 origin/master 分 支 上 的 修改 合并 到 主 分 支 上 即 可 ， 如 下 所 示 : 


git merge origin/master 


而 puLL 命 令 则 是 相当 于 将 fetch 和 me rge 这 两 个 命令 放 在 一 起 执行 了 ，, 它 可 以 从 远程 版 本 库 上 
获取 最 新 的 代码 并 且 合 并 到 本 地 ， 用 法 如 下 所 示 : 


git pull origin master 


也 许 你 现在 对 远程 版 本 库 的 使 用 还 是 感觉 比较 抽象 ， 没 关系 ， 因 为 暂时 我 们 只 是 了 解 了 一 下 命 
令 的 用 法 ， 还 没 进行 实践 ， 在 第 15 章 当中 ， 你 将 会 对 远程 版 本 库 的 用 法 有 更 深 一 层 的 认识 。 
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12.10 小结 与 点 评 


学 完了 本 章 的 所 有 知识 ， 你 有 没有 觉得 无 比 兴 奋 呢 ? 反正 我 是 这 么 觉得 的 。 本 章 我 们 的 收获 实 
在 是 太 多 了 ， 一 开始 创建 了 一 个 什么 都 没有 的 空 项 目 ， 经 过 一 章 的 学 习 ， 最 后 实现 了 一 个 功能 
如 此 丰富 、 界 面 如 此 华丽 的 应 用 ， 还 有 什么 事情 比 这 个 更 让 我 们 有 成 就 感 吗 ? 


本 章 中 我 们 充分 利用 了 Material 库 、AndroidX 库 以 及 一 些 开源 项 目 ， 实现 了 一 个 高 度 Material 
化 的 应 用 程序 。 能 将 这 些 库 中 的 相关 控件 熟练 掌握 ,你 的 Material Design 技 术 就 算是 合格 了 。 


不 过 说 到 底 ， 我 仍然 还 是 在 以 开发 者 的 思维 给 你 讲解 Material Design， 侧重 于 如 何 去 实 现 这 些 
效果 。 而 实际 上 ,Material Design 的 设计 思维 和 设计 理念 才 是 更 加 重要 的 东西 。 当 然 ， 这 部 分 
内 容 其 实 应 该 是 UI 设计 人 员 去 学 习 的 ， 如果 你 也 感 兴趣 的 话 ， 可 以 参考 一 下 Material Design 的 
官方 网 站 : https://material.io/。 


至 于 本 章 的 Kotlin 课 堂 ， 我 们 并 没有 学 习 什么 新 的 知识 ， 而 是 通过 编写 几 个 工具 方法 的 示例 来 引 
导 你 学 会 对 Kotlin 的 各 种 特性 进行 灵活 运用 。 知 识 好 学 ， 但 是 思维 却 是 很 难 培养 的 ， 也 希望 经 过 
本 节 课 的 学 习 能 让 你 引发 更 多 的 思考 。 

除 此 之 外 ， 在 本 章 的 Git 时 间 中 ， 我 们 继续 对 Git 的 用 法 进行 了 更 深 一 步 的 探究 ， 相 信 你 对 分 支 和 
远程 版 本 库 的 使 用 都 有 了 一 定 层 次 的 了 解 。 


现在 你 已 经 足 足 学 习 了 12 章 的 内 容 ， 对 Android 应 用 程序 开发 的 理解 应 该 比较 深刻 了 。 那 么 掌 
握 了 这 么 多 的 知识 ， 就 可 以 开发 出 一 款 好 的 应 用 程序 了 吗 ? 说 实话 ， 现 在 的 你 还 差 了 些 火候 ， 

因为 你 还 不 知道 该 如 何 搭建 一 个 出 色 的 代码 架构 体系 。 当 然 这 也 是 我 们 下 一 章 中 即将 学 习 的 内 
容 了 一 一 高 级 程序 开发 组 件 Jetpack。 
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第 13 章 高 级 程序 开发 组 件 ， 探究 jetpack 


学 到 这 里 ， 现 在 的 你 已 经 完全 具备 了 独立 开发 一 款 Android App 的 能 力 。 但 是 ， 能 够 开发 出 一 
款 App 和 能 够 开发 出 一 款 好 的 App 并 不 是 一 回 事 。 这 里 的 “好 ” 指 的 是 代码 质量 优越 ， 项 目 架 构 
合理 ， 并 不 是 产品 本 身 好 不 好 。 


长 久 以 来 , Android 官 方 并 没有 制定 一 个 项 目 架 构 的 规范 ， 只 要 能 够 实现 功能 ， 代 码 怎么 编写 都 
是 你 的 自由 。 但 是 不 同 的 人 技术 水 平 不 同 ， 最终 编写 出 来 的 代码 质量 是 干 差 万 别 的 。 


由 于 Android 官 方 没有 制定 规范 ， 为 了 追求 更 高 的 代码 质量 ， 慢 慢 就 有 第 三 方 的 社区 和 开发 者 将 
一 些 更 加 高 级 的 项 目 架 构 引 入 到 了 Android 平 台 上 , 如 MVP、MVVM 等 。 使 用 这 些 架 构 开 发 出 
来 的 应 用 程序 ,在 代码 质量 、 可 读 性 、 易 维护 性 等 方面 都 有 着 更 加 出 色 的 表现 ， 于 是 这 些 架 构 
渐渐 成 为 了 主流 。 


后 来 Google 或 许 意识 到 了 这 个 情况 ， 终 于 在 2017 年 ， 推 出 了 一 个 官方 的 架构 组 件 库 一 一 
Architecture Components ,站 在 帮助 开发 者 编写 出 更 加 符合 高 质量 代码 规范 、 更 具有 架构 设 
计 的 应 用 程序 。2018 年 ，Google 又 推出 了 一 个 全 新 的 开发 组 件 工 具 集 jetpack ,并 将 
Architecture Components 作 为 Jetpack 的 一 部 分 纳入 其 中 。 当 然 ，jJetpack 并 没有 就 此 定 
版 ,2019 年 又 有 许多 新 的 组 件 被 加 入 Jetpack 当 中 ， 未 来 的 Jetpack 还 会 不 断 地 继续 扩充 。 


本 章 我 们 就 来 对 Jetpack 中 的 重要 知识 点 进行 学 习 。 
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13.1 Jetpack 人 简介 


jetpack 是 一 个 开发 组 件 工具 集 , 它 的 主要 目的 是 帮助 我 们 编写 出 更 加 简洁 的 代码 ， 并 简化 我 们 
的 开发 过 程 。Jetpack 中 的 组 件 有 一 个 特点 ， 它 们 大 部 分 不 依赖 于 任何 Android 系 统 版 本 ， 这 意 


味 着 这 些 组 件 通 常 是 定义 在 AndroidX 库 当中 的 ， 并 且 拥 有 非常 好 的 向 下 兼容 性 。 
我 们 先 来 看 一 张 jetpack 目 前 的 “全 家 福 ”, 如 图 13.1 所 示 。 


横向 功能 ， 例 知 向 后 兼 宕 性 、 测 
= 


架构 组 件 可 帮助 您 设计 稳健 ， 可 测试 是 昂 维护 的 
应 用 。 


二 
行为 

行为 组 人 R 住 Android 服务 
(如 通知 、 权 限 , 和 Google 助理 ) 相 华 


Android KTX 数据 绑 定 CameraX 动画 和 过 渡 
编写 更 简洁 、 惯 用 的 Kctlin 代码 以 声明 方式 将 可 观察 数据 蝴 定 到 界面 元 素 轻松 地 向 应 用 中 添加 相机 功能 移动 向 件 和 在 屏 和 看 之 间 过 派 
AppCompat Lifecycles 下 载 答 理 器 表情 符号 
在 较 全 版 本 的 Android 系统 上 恰当 地 降级 管理 您 的 Activity 和 Fragment 生 会 局 期 安 间 和 管理 大 量 下 载 任务 在 旧版 平台 上 启用 扰 新 的 表情 符号 字体 
Auto LiveData 媒体 和 播放 Fragment 

有 有 于 开发 Android Auto 应 用 的 组 件 在 底层 数据 库 更 改 时 通知 视图 用 于 媒体 播放 和 路 由 ( 包括 Google Cast ) 的 组 件 化 界面 的 基本 单位 

检测 Navigation AD 布局 

从 Android Studio 中 快速 检测 苦于 Kotlin 或 处 理应 用 内 导航 所 需 的 一 切 后 使 用 下 同 的 算法 布置 微 件 

Java 的 代码 提供 向 后 兼容 的 通知 AP1 , 支持 Wear 和 Auto 

Paging 调 色 板 
外 逐 步 从 您 的 数据 源 撤 需 加 载 信息 要 几 从 请 色 板 中 提取 出 有 月 的 信息 


用 于 检查 和 请 求 应 用 权限 的 兼容 性 API 


偏 


为 具有 多 个 DEX 文件 的 应 用 提供 支持 
Room 


by 流畅 地 访问 SQLite 数 据 库 
接 旺 安全 最 佳 做 法 这 写 加 密 文 件 和 共享 仿 好 设 
置 . ViewModel 


测试 以 注重 生命 周期 的 方式 管理 界面 相关 的 救 据 


WorkManager 


用 于 单元 和 话 行 时 界面 测试 的 Androld 测试 框 
加 片 


管理 您 的 Android 后 台 作业 


切 
TV 创建 可 在 应 用 外 部 显示 应 用 数据 的 灵活 界面 元 


有 助 于 开发 Android TV 应 用 的 组 件 


图 13.1 jetpack“ 全 家 福 ” 


可 以 看 到 ， jetpack 的 家 族 还 是 非常 庞大 的 ， 主 要 由 基础 、 架 构 、 行 为 、 界 面 这 4 个 部 分 组 成 。 
你 会 发 现 ， 里 面 有 许多 东西 是 我 们 已 经 学 过 的 ， 像 通知 、 权 限 、Fragment 都 属于 jetpack。 由 
此 可 见 ，jJetpack 并 不 全 是 些 新 东西 ， 只 要 是 能 够 帮助 开发 者 更 好 更 方便 地 构建 应 用 程序 的 组 
件 ,Google 都 将 其 纳入 了 Jetpack。 


显然 这 里 我 们 不 可 能 将 Jetpack 中 的 每 一 个 组 件 都 进行 学 习 ， 那 将 会 是 一 个 极 大 的 工程 。 事 实 
上 , 在 这 么 多 的 组 件 当 中 ， 最 需要 我 们 关注 的 其 实 还 是 架构 组 件 。 目 前 Android 官 方 最 为 推荐 的 
项 目 架构 就 是 MVVM ,因而 Jetpack 中 的 许多 架构 组 件 是 专门 为 MVVM 染 构 量 身 打造 的 。 那 么 本 
章 我 们 先 来 对 Jetpack 的 主要 架构 组 件 进行 学 习 ， 至 于 MVVM 架 构 ， 将 会 在 第 15 章 的 项 目 实战 
环节 进行 介绍 。 


新 建 一 个 JetpackTest 工 程 ， 然后 开启 我 们 的 Jetpack 探 索 之 旅 吧 。 
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13.2 ViewModel 


ViewModel 应 该 可 以 算是 Jetpack 中 最 重要 的 组 件 之 一 了 。 其 实 Android 平 台 上 之 所 以 会 出 现 诸 
如 MVP、MVVM 之 类 的 项 目 架 构 ， 就 是 因为 在 传统 的 开发 模式 下 ，Activity 的 任务 实在 是 太 重 
了 , 既 要 负责 逻辑 处 理 ， 又 要 控制 Ul 展 示 ， 甚 至 还 得 处 理 网 络 回调 ， 等 等 。 在 一 个 小 型 项 目 中 
这 样 写 或 许 没 有 什么 问题 ， 但 是 如 果 在 大 型 项 目 中 仍然 使 用 这 种 写法 的 话 ， 那 么 这 个 项 目 将 会 
变 得 非常 腑 肿 并 且 难 以 维护 ， 因 为 没有 任何 架构 上 的 划分 。 


而 ViewModel 的 一 个 重要 作用 就 是 可 以 帮助 Activity 分 担 一 部 分 工作 ， 它 是 专门 用 于 存放 与 界 
面相 关 的 数据 的 。 也 就 是 说 ， 只 要 是 界面 上 能 看 得 到 的 数据 ， 它 的 相关 变量 都 应 该 存放 在 
ViewModel 中 ， 而 不 是 Activity 中 ,这样 可 以 在 一 定 程度 上 减少 Activity 中 的 逻辑 。 


另外 ，ViewModel 还 有 一 个 非常 重要 的 特性 。 我 们 都 知道 ， 当 于 机 发 生 横 坚 屏 旋转 的 时 候 ， 
Activity 会 被 重新 创建 ， 同 时 存放 在 Activity 中 的 数据 也 会 丢失 。 而 ViewModel 的 生命 周期 和 
Activity 不 同 ， 它 可 以 保证 在 手机 屏幕 发 生 旋转 的 时 候 不 会 被 重新 创建 ， 只 有 当 Activity 退 出 的 
时 候 才 会 跟着 Activity 一 起 销毁 。 因 此 ， 将 与 界面 相关 的 变量 存放 在 ViewModel 当 中 ， 这样 即 
使 旋转 手机 屏幕 ,界面 上 显示 的 数据 也 不 会 丢失 。ViewModel 的 生命 周期 如 图 13.2 所 示 。 


Activity ViewModel 


Activity 创建 onCreate() 
onStart() 


onResume() 
Activity 旋转 
onPause() 
onStop() 


onDestroy() ViewModel 


对 他 期 


onCreate() 
onStart() 


onResume() 
调用 finish() 方法 


onPause() 
onStop() 


onDestroy() 


Activity 销毁 onCleared!() 


图 13.2 ViewModel 的 生命 周期 示意 图 
接 下 来 就 让 我 们 通过 一 个 简单 的 计数 颖 示例 来 学 习 ViewModel 的 基本 用 法 。 
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13.2.1 ViewModel 的 基本 用 法 


由 于 Jetpack 中 的 组 件 通常 是 以 AndroidX 库 的 形式 发 布 的 ， 因此 一 些 常 用 的 Jetpack 组 件 会 在 创 
建 Android 项 目 时 自动 被 包含 进去 。 不 过 如 果 我 们 想 要 使 用 ViewModel 组 件 ， 还 需要 在 
app/build.gradle 文 件 中 添加 如 下 依赖 : 


dependencies { 


implementation "androidx.lifecycle:lifecycle-extensions:2.2.0" 


} 


通常 来 讲 ， 比较 好 的 编程 规范 是 给 每 一 个 Activity 和 Fragment 都 创建 一 个 对 应 的 ViewModel ， 
因此 这 里 我 们 就 为 MainActivity 创 建 一 个 对 应 的 MainViewModel 类 ， 并 让 它 继承 自 
ViewModel , 代码 如 下 所 示 : 


class MainViewModel : ViewModel() { 


} 


根据 前 面 所 学 的 知识 ， 所 有 与 界面 相关 的 数据 都 应 该 放 在 ViewModel 中 。 那 么 这 里 我 们 要 实现 
一 个 计数 器 的 功能 ， 就 可 以 在 ViewModel 中 加 入 一 个 counter 变 量 用 于 计数 , 如 下 所 示 : 


class MainViewModel : ViewModel() { 


var counter = 0 


现在 我 们 需要 在 界面 上 添加 一 个 按钮 ， 每 点 击 一 次 按钮 就 让 计数 占 加 1 ， 并 且 把 最 新 的 计数 显示 
在 界面 上 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 


<TextView 
android:id="@+id/infoText" 
android:layout width="wrap _ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:textSize="32sp"/> 


<Button 
android:id="@+id/plusOneBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Plus One"/> 


</LinearLayout> 


布局 文件 非常 简单 ， 一 个 TextView 用 于 显示 当前 的 计数 ， 一 个 Button 用 于 对 计数 器 加 1。 
接着 我 们 开始 实现 计数 器 的 逻辑 ， 修 改 MainActivity 中 的 代码 , 如 下 所 示 : 
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class MainActivity : AppCompatActivity() { 
lateinit var viewModel: MainViewModel 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
viewModel = ViewModelProvider(this).get(MainViewModel::class.java) 
plusOneBtn.setOnClickListener { 
viewModel .counter++ 
refreshCounter() 


refreshCounter() 


} 


private fun refreshCounter() { 
infoText.text = viewModel .counter.toString() 


} 


} 


代码 不 长 ， 我 来 解释 一 下 。 这 里 最 需要 注意 的 是 ， 我们 绝对 不 可 以 直接 去 创建 ViewModel 的 实 
例 , 而 是 一 定 要 通过 ViewModelProvider 来 获取 ViewModel 的 实例 ， 具体 语法 规则 如 下 : 


ViewModelProvider (< 你 的 Activity 或 Fragment 实 例 >) .get (< 你 的 VijewModel>::class.java) 


之 所 以 要 这 么 写 ,是 因为 ViewModel 有 其 独立 的 生命 周期 ， 并 且 其 生命 周期 要 长 于 Activity。 
如 果 我 们 在 onCreate ( ) 方 法 中 创建 ViewModel 的 实例 ， 那么 每 次 onCreate( ) 方 法 执行 的 时 
候 ，ViewModel 都 会 创建 一 个 新 的 实例 ， 这样 当 手机 屏幕 发 生 旋转 的 时 候 ， 就 无 法 保留 其 中 的 
数据 了 。 


除 此 之 外 的 其 他 代码 应 该 都 是 非常 好 理解 的 ， 我 们 提供 了 一 个 refreshCounter() 方 法 用 来 显 
示 当 前 的 计数 ， 然 后 每 次 点 击 按钮 的 时 候 对 计数 器 加 1 ,并 调用 refreshCounter() 方 法 刷新 
计数 。 


现在 可 以 运行 一 下 程序 了 ， 效 果 如 图 13.3 所 示 。 
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9:20 :A 


JetpackTest 


0 


PLUS ONE 


图 13.3 程序 的 初始 界面 
点 击 界面 上 的 “Plus One" 按 钮 ,计数 絮 就 会 开始 增长 了 ,如 图 13.4 所 示 。 
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9:22 :A 


JetpackTest 


6 


PLUS ONE 


图 13.4 ”点击 按钮 计数 器 增长 


如 果 你 尝试 通过 侧 边 工具 栏 旋转 一 下 模拟 融 的 屏幕 ， 就 会 发 现 Activity 虽 然 被 重新 创建 了 ， 但 是 
计数 希 的 数据 却 没有 丢失 ， 如 图 13.5 所 示 。 
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9:29 


JetpackTest 


6 回 


PLUS ONE 


图 13.5 ViewModel 中 的 数据 在 屏幕 旋转 时 不 会 于 失 


虽然 这 个 例子 非常 简单 ， st 它 最 常用 的 用 法 ， 所 以 你 一 
定 要 牢 牢 掌握 这 部 分 内 容 。 不 过 在 实际 的 使 用 过 程 中 ， 你 还 遇 到 一 些 特殊 的 情况 ， 那 么 
下 面 我 们 就 来 进行 更 深 一 步 的 学 习 。 


13.2.2 向 ViewModel 传 递 参数 


上 一 小 节 中 创建 的 MainViewModelI 的 构造 永 数 中 没有 任何 参数 ,但 是 思考 一 下 ， 如 果 我 们 确实 
需要 通过 构造 函数 来 传递 一 些 参数 ,应 该 怎么 办 呢 ? 由 于 所 有 ViewModel 的 实例 都 是 通过 
ViewModelProvider 来 获取 的 ， 因 此 我 们 没有 任何 地 方 可 以 向 ViewModel 的 构造 范 数 中 传递 参 
数 。 


当然 ， 这 个 问题 也 不 难 解 决 ， 只 需要 借助 ViewModelProvider.Factory 就 可 以 实现 了 。 下 
面 我 们 还 是 通过 具体 的 示例 来 学 习 一 下 。 


现在 的 计数 竟 虽 然 在 屏幕 旋转 的 时 候 不 会 丢失 数据 ， 但 是 如 果 退 出 程序 之 后 再 重新 打开 ， 那 么 
之 前 的 计数 就 会 被 清 零 了 。 接 下 来 我 们 就 对 这 一 功能 进行 升级 ， 保 证 即使 在 退出 程序 后 又 重新 
打开 的 情况 下 ， 数据 仍然 不 会 丢失 。 


相信 你 已 经 猜 到 了 ， 实现 这 个 功能 需要 在 退出 程序 的 时 候 对 当前 的 计数 进行 保存 ， 然 后 在 重新 
打开 程序 的 时 候 读 取 之 前 保存 的 计数 ， 并 传递 给 MainViewModel。 因 此 , 这 里 修改 
MainViewModel 中 的 代码 , 如 下 所 示 : 


class MainViewModel (countReserved: Int) : ViewModel() { 
var counter = countReserved 


} 


现在 我 们 给 MainViewModel 的 构造 函数 添加 了 一 个 countReserved 参 数 ， 这 个 参数 用 于 记录 
之 前 保存 的 计数 值 ， 并 在 初始 化 的 时 候 赋 值 给 counter 变 量 。 
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接 下 来 的 问题 就 是 如 何 向 MainViewModel 的 构造 函数 传 递 数 据 了 ， 前面 已 经 说 了 需要 借助 
ViewModelProvider.Factory , 下面 我 们 就 来 看 看 具体 应 该 如 何 实现 。 


新 建 一 个 MainViewModelFactory 类 ， 并 让 它 实 现 ViewModelProvider.Factory 接 口 ， 
代码 如 下 所 示 : 


class MainViewModelFactory(private val countReserved: Int) : ViewModelProvider.Factory { 


override fun <T : ViewModel> create(modelClass: Class<T>): T { 
return MainViewModel (countReserved) as T 


} 


可 以 看 到 ， MainViewModeLFactory 的 构造 水 数 中 也 接收 了 一 个 countReserved 参 数 。 另 外 
ViewModeLProvider.Factory 接 口 要求 我 们 必须 实现 Create ( ) 方 法 ， 因 此 这 里 在 
create( ) 方 法 中 我 们 创建 了 MainViewModelI 的 实例 ， 并 将 CountReserved 参 数 传 了 进去 。 
为 什么 这 里 就 可 以 创建 MainViewModel 的 实例 了 呢 ? 因为 create ( ) 方 法 的 执行 时 机 和 
Activity 的 生命 周期 无 关 ， 所 以 不 会 产生 之 前 提 到 的 问题 。 


另外 ， 我们 还 得 在 界面 上 添加 一 个 清 零 按钮 , 方便 用 户 手动 将 计数 器 清 零 。 修 改 
activity_ main.xml 中 的 代码 ， 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:id="@+id/clearBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Clear"/> 
</LinearLayout> 


最 后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


lateinit var viewModel: MainViewModel 
lateinit var sp: SharedPreferences 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
sp = getPreferences(Context.MODE PRIVATE) 
val countReserved = sp.getInt("count reserved", 0) 
viewModel = ViewModelProvider(this, MainViewModelFactory(countReserved)) 
.get (MainViewModel::class.java) 


clearBtn.setOnClickListener { 
viewModel .counter = 0 
refreshCounter() 


} 


refreshCounter() 
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} 


override fun onPause() { 
super.onPause() 
sp.edit { 
putInt("count reserved", viewModel .counter) 


} 


在 onCreate ( ) 方 法 中 ， 我们 首先 获取 了 SharedPreferences 的 实例 ， 然 后 读 取 之 前 保存 的 计 
数值 ， 如 果 没 有 读 到 的 话 ， 就 使 用 0 作为 默认 值 。 接 下 来 在 ViewModelProvider 中 ， 额 外 传 入 
了 一 个 MainViewModelFactory 参 数 ， 这 里 将 读 取 到 的 计数 值 传 给 了 
MainViewModelFactory 的 构造 水 数 。 注 意 ， 这 一 步 是 非常 重要 的 ， 只 有 用 这 种 写法 才能 将 
计数 值 最 终 传递 给 MainViewModel 的 构造 限 数 。 

剩 下 的 代码 就 比较 简单 了 ， 我 们 在 “Clear” 按 钮 的 点 击 事件 中 对 计数 器 进行 清 零 ， 并 且 在 
onPause() 方 法 中 对 当前 的 计数 进行 保存 ， 这样 可 以 保证 不 管 程序 是 退出 还 是 进入 后 台 ， 计数 
都 不 会 丢失 。 


现在 重新 运行 程序 ， 点击 数 次 “Plus One” 按 钮 ， 然后 退出 程序 并 重新 打开 ， 你 会 发 现 ， 计数 器 
的 值 是 不 会 丢失 的 ， 如 图 13.6 所 示 。 
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8 


PLUS ONE 


CLEAR 


图 13.6 计数 器 的 值 会 被 一 直 保 存 
只 有 点 击 “Clear" 按 钮 ， 计数 器 的 值 才 会 被 清 零 ， 你 可 以 自己 尝试 一 下 。 


这 样 我 们 就 把 ViewModel 中 比较 重要 的 内 容 都 掌握 了 ， 那么 接 下 来 我 们 开始 学 习 Jetpack 中 另 
外 一 个 非常 重要 的 组 件 一 一 Lifecycles。 
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13.3 Lifecycles 


在 编写 Android 应 用 程序 的 时 候 ， 可 能 会 经 常 遇 到 需要 感知 Activity 生 命 周期 的 情况 。 比 如 说 ， 

某 个 界面 中 发 起 了 一 条 网 络 请 求 ， 但 是 当 请 求 得 到 响应 的 时 候 ， 界 面 或 许 已 经 关闭 了 ， 这 个 时 

候 就 不 应 该 继续 对 响应 的 结果 进行 处 理 。 因 此 ， 我们 需要 能 够 时 刻 感 知 到 Activity 的 生命 周期 ， 
以 便 在 适当 的 时 候 进 行 相应 的 逻辑 控制 。 

感知 Activity 的 生命 周期 并 不 复杂 , 早 在 第 3 章 的 时 候 我 们 就 学 习 过 Activity 完 整 的 生命 周期 流 
程 。 但 问题 在 于 ,在 一 个 Activity 中 去 感知 它 的 生命 周期 非常 简单 ， 而 如 果 要 在 一 个 非 Activity 
的 类 中 去 感知 Activity 的 生命 周期 ,应 该 怎么 办 呢 ? 


这 种 需求 是 广泛 存在 的 ， 同 时 也 衍生 出 了 一 系列 的 解决 方案 ,比如 通过 在 Activity 中 肉 入 一 个 隐 
藏 的 FFagment 来 进行 感知 ， 或 者 通过 手写 监听 器 的 方式 来 进行 感知 ， 等 等 。 


下 面 的 代码 演示 了 如 何 通 过 手写 监听 器 的 方式 来 对 Activity 的 生命 周期 进行 感知 : 


class MyObserver { 


fun activityStart() { 


fun activityStop() { 


} 
class MainActivity : AppCompatActivity() { 
Lateinit var observer: MyObserver 


override fun onCreate(savedInstanceState: Bundle?) { 
observer = MyObserver() 


} 


override fun onStart() { 
super.onStart() 
observer.activityStart() 


} 


override fun onStop() { 
super.onStop() 
observer.activityStop() 


} 


} 
可 以 看 到 ， 这 里 我 们 为 了 让 MyObserver 能 够 感知 到 Activity 的 生命 周期 ， 需 要 专门 在 


MainActivity 中 重 写 相应 的 生命 周期 方法 ,然后 再 通知 给 MyObserver。 这 种 实现 方式 虽然 是 
可 以 正常 工作 的 ， 但 是 不 够 优雅 ， 需 要 在 Activity 中 编写 太 多 额外 的 逻辑 。 


而 Lifecycles 组 件 就 是 为 了 解决 这 个 问题 而 出 现 的 ， 它 可 以 让 任何 一 个 类 都 能 轻松 感知 到 
Activity 的 生命 周期 ， 同 时 又 不 需要 在 Activity 中 编写 大 量 的 逻辑 处 理 。 
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那么 下 面 我 们 就 通过 具体 的 例子 来 学 习 Lifecycles 组 件 的 用 法 。 新 建 一 个 My0bserver 类 ,并 让 
它 实现 LifecycLe0bserver 接 口 ， 代 码 如 下 所 示 : 


class MyObserver : LifecycLe0bserver { 


} 


LifecycLe0bserver 是 一 个 空 方法 接口 ,只 需要 进行 一 下 接口 实现 声明 就 可 以 了 ， 而 不 去 重 

写 任何 方法 。 

接 下 来 我 们 可 以 在 MyObserver 中 定义 任何 方法 ， 但 是 如 果 想 要 感知 到 Activity 的 生命 周期 ， 还 
得 借助 额外 的 注解 功能 才 行 。 比 如 这 里 还 是 定义 activityStart() 和 activityStop () 这 两 
个 方法 ,代码 如 下 所 示 : 


class MyObserver : LifecycleObserver { 


@OnLifecycleEvent(Lifecycle.Event.ON START) 
fun activityStart() { 
Log.d("MyObserver", "activityStart") 


@OnLifecycleEvent (Lifecycle.Event.ON STOP) 
fun activityStop() { 
Log.d("MyObserver", "activityStop") 


} 


可 以 看 到 ， 我 们 在 方法 上 使 用 了 GO0nLifecycLeEvent 注 解 ， 并 传 入 了 一 种 生命 周期 事件 。 生 
命 周期 事件 的 类 型 一 共有 7 种 : ON CREATE、ON START、ON RESUME、ON PAUSE、 
ON_STOP 和 0N_DESTROY 分 别 匹配 Activity 中 相应 的 生命 周期 回调 ; 另外 还 有 一 种 ON_ANY 类 
型 ,表示 可 以 匹配 Activity 的 任何 生命 周期 回调 。 


因此 ， 上 述 代 码 中 的 activityStart() 和 activityStop() 方 法 就 应 该 分 别 在 Activity 的 
onStart() 和 onStop () 触 发 的 时 候 执 行 。 

但 是 代码 写 到 这 里 还 是 无 法 正常 工作 的 ， 因 为 当 Activity 的 生命 周期 发 生变 化 的 时 候 并 没有 人 去 
通知 MyObserver， 而 我 们 又 不 想像 刚才 一 样 在 Activity 中 去 一 个 个 手动 通知 。 


这 个 时 候 就 得 借助 LifecycleOwner 这 个 好 帮手 了 ， 它 可 以 使 用 如 下 的 语法 结构 让 MyObserver 
得 到 通知 : 


lifecycleOwner.lifecycle.addObserver(MyObserver()) 


首先 调用 LifecycleOwner 的 getLifecycle() 方 法 ,得 到 一 个 Lifecycle 对 象 ， 然 后 调用 它 
的 add0bserver() 方 法 来 观察 LifecycleOwner 的 生命 周期 ， 再 把 MyObserver 的 实例 传 进去 
就 可 以 了 。 


那么 接 下 来 的 问题 就 是 ,LifecycleOwner 又 是 什么 呢 ? 怎样 才能 获取 一 个 LifecycleOwner 的 
实例 ? 
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当然 ， 我 们 可 以 自己 去 实现 一 个 LifecycleOwner , 但 通常 情况 下 这 是 完全 没有 必要 的 。 因 为 只 
要 你 的 Activity 是 继承 自 AppCompatActivity 的 ,或 者 你 的 FFagment 是 继承 自 
androidx.fragment.app.Fragment 的 ,那么 它们 本 身 就 是 一 个 LifecycleOwner 的 实例 ， 
这 部 分 工作 已 经 由 AndroidX 库 自动 帮 有 我 们 完成 了 。 也 就 是 说 ， 在 MainActivity 当 中 就 可 以 这 样 
与 二 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 


lifecycle .addObserver(MyObserver()) 
} 


} 


没 错 ， 只 要 添加 这 样 一 行 代 码 ，MyObserver 就 能 自动 感知 到 Activity 的 生命 周期 了 7 了。 另外 ， 需 
要 说 明 的 是 ， 尽管 我 们 一 直 在 以 Activity 举 例 , 但 其 实 上 述 的 所 有 内 容 在 Fragment 中 也 是 通用 
的 。 


现在 重新 运行 一 下 程序 ，activityStart 这 条 日 志 就 会 打印 出 来 了 。 如 果 你 再 按 下 Home 键 或 者 
Back 键 的 话 ,activityStop 这 条 日 志 也 会 打印 出 来 ， 如 图 13.7 所 示 。 


com.example.jetpacktest (22274) 地 Verbose “地 


274/com,exampLe, jetpacktest D/MyObserver: activityStart 
274/com.example.jetpacktest D/MyObserver: activityStop 


图 13.7 MyObserver 中 打印 的 日 志 


这 些 就 是 Lifecycles 组 件 最 常见 的 用 法 了 。 不 过 目前 MyObserver 虽 然 能 够 感知 到 Activity 的 生 
命 周 期 发 生 了 变化 ， 却 没有 办 法 主动 获知 当前 的 生命 周期 状态 。 要 解决 这 个 问题 也 不 难 ， 只 需 
要 在 MyObserver 的 构造 水 数 中 将 LifecyctLe 对 象 传 进来 即 可 ,如 下 所 示 : 


class MyObserver(val lifecycle: Lifecycle) : LifecycleObserver { 


} 


有 了 Lifecycle 对 和 象 之 后 ,我 们 就 可 以 在 任何 地 方 调用 Lifecycle.currentState 来 主动 获 
知 当前 的 生命 周期 状态 。LifecyctLe,currentState 返 回 的 生命 周期 状态 是 一 个 枚 举 类 型 ， 
一 共有 INITIALIZED、DESTROYED、CREATED、STARTED、RESUMED 这 5 种 状态 类 型 ,它们 
与 Activity 的 生命 周期 回调 所 对 应 的 关系 如 图 13.8 所 示 。 
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状态 INITIALIZED 


ON_CREATE 


DESTROYED CREATED 


P| 


事件 


状态 INITIALIZED 


图 13.8 Activity 生 命 周 期 状态 与 事件 的 对 应 关系 
也 就 是 说 ， 当 获取 的 生命 周期 状态 是 CREATED 的 时 候 


方法 已 经 执行 了 ， 但 是 onResume ( ) 方 法 还 没有 执行 ， 


ON_DESTROY 


DESTROYED CREATED 
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ON_START 


ON_STOP 


STARTED 


STARTED 


ON_RESUME 


ON_PAUSE 


RESUMED 


RESUMED 


, 说 明 onCreate( ) 方 法 已 经 执行 了 ,但 
是 onStart () 方 法 还 没有 执行 。 当 获取 的 生命 周期 状态 是 STARTED 的 时 候 ， 说 明 onStart () 
以 此 类 推 。 


到 这 里 ，Lifecycles 组 件 的 重要 内 容 就 基本 讲 完 了 ,目前 我 们 已 经 掌握 了 jetpack 中 的 两 个 重要 
组 件 。 但 是 这 两 个 组 件 是 相对 比较 独立 的 ， 并 没有 太 多 直接 的 关系 。 为 了 让 各 个 组 件 可 以 更 好 
地 结合 使 用 , 接 下 来 我 们 就 开始 学 习 jJetpack 中 另外 一 个 非常 重要 的 组 件 一 一 LiveData。 


13.4 LiveData 


LiveData 是 Jetpack 提 供 的 一 种 响应 式 编程 组 件 ， 它 可 以 包含 任何 类 型 的 数据 ， 并 在 数据 发 生 
变化 的 时 候 通知 给 观察 者 。LiveData 特 别 适 合 与 ViewModel 结 合 在 一 起 使 用 ， 虽 然 它 也 可 以 单 
独 用 在 别 的 地 方 ， 但 是 在 绝 大 多 数 情况 下 ， 它 是 使 用 在 ViewModel 当 中 的 。 


下 面 我 们 还 是 通过 编写 示例 的 方式 来 学 习 LiveData 的 具体 用 法 。 
13.4.1 LiveData 的 基本 用 法 


之 前 我 们 编写 的 那个 计数 器 虽然 功能 非常 简单 ， 但 其 实 是 存在 问题 的 。 目 前 的 逻辑 是 ， 当 每 次 
点 击 “Plus One” 按 钮 时 ， 都 会 先 给 ViewModel 中 的 计数 加 1 ， 然 后 立即 获取 最 新 的 计数 。 这 种 
方式 在 单线 程 模式 下 确实 可 以 正常 工作 ， 但 如 果 ViewModel 的 内 部 开局 了 线程 去 执行 一 些 耗 时 
逻辑 ,那么 在 点 击 按钮 后 就 立即 去 获取 最 新 的 数据 ， 得 到 的 肯定 还 是 之 前 的 数据 。 


你 会 发 现 ， 原 来 我 们 一 直 使 用 的 都 是 在 Activity 中 手动 获取 ViewModel 中 的 数据 这 种 交互 方 
式 ， 但 是 ViewModel 却 无 法 将 数据 的 变化 主动 通知 给 Activity。 


或 许 你 会 说 ， 我 把 Activity 的 实例 传 给 ViewModel , 这 样 ViewModel 不 就 能 主动 对 Activity 进 

行 通 知 了 吗 ? 注意 ，, 干 万 不 可 以 这 么 做 。 不 要 忘 了 ，ViewModel 的 生命 周期 是 长 于 Activity 

的 ， 如 果 把 Activity 的 实例 传 给 ViewModel , 就 很 有 可 能 会 因为 Activity 无 法 释放 而 造成 内 存 泄 
漏 , 这 是 一 种 非常 错误 的 做 法 。 

而 这 个 问题 的 解决 方案 也 是 显而易见 的 ， 就 是 使 用 我 们 本 节 即 将 学 习 的 LiveData。 正 如 前 面 所 
描述 的 一 样 ，LiveData 可 以 包含 任何 类 型 的 数据 ， 并 在 数据 发 生变 化 的 时 候 通 知 给 观察 者 。 也 
就 是 说 ， 如 果 我 们 将 计数 器 的 计数 使 用 LiveData 来 包装 ， 然 后 在 Activity 中 去 观察 它 ， 就 可 以 

主动 将 数据 变化 通知 给 Activity 了 。 


介绍 完了 工作 原理 ， 接 下 来 我 们 开始 编写 具体 的 代码 ,修改 MainViewModel 中 的 代码 ,如 下 所 
小 : 


class MainViewModel (countReserved: Int) : ViewModel() { 
val counter = MutableLiveData<Int>() 
init { 


counter.value = countReserved 


fun plusOne() { 
val count = counter.value ?: 0 
counter.value = count + 1 


fun clear() { 
counter.value = 0 
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这 里 我 们 将 counter 变 量 修改 成 了 一 个 MutabLeLiveData 对 象 ， 并 指定 它 的 泛 型 为 Int , 表 
示 它 包含 的 是 整 型 数据 。MutabtLeLiveData 是 一 种 可 变 的 LiveData , 它 的 用 法 很 简单 ， 主 要 
有 3 种 读 写 数据 的 方法 ， 分别 是 getValue()、setValue() 和 postValue() 方 法 。 
getValue() 方 法 用 于 获取 LiveData 中 包含 的 数据 ; setValue( ) 方 法 用 于 给 LiveData 设 置 数 
据 ,但 是 只 能 在 主线 程 中 调用 ; postValue() 方 法 用 于 在 非 主 线程 中 给 LiveData 设 置 数据 。 
而 上 述 代码 其 实 就 是 调用 getValue() 和 setValue() 方 法 对 应 的 语法 糖 写法 。 


可 以 看 到 ， 这 里 在 init 结 构 体 中 给 counter 设 置 数据 ， 这样 之 前 保存 的 计数 值 就 可 以 在 初始 化 
的 时 候 得 至 恢复。 接 下 来 我 们 新 增 了 plus0ne() 和 clear() 这 两 个 方法 ,分 别 用 于 给 计数 加 1 
以 及 将 计数 清 零 。plus0ne() 方 法 中 的 逻辑 是 先 获取 counter 中 包含 的 数据 ， 然 后 给 它 加 1 ， 
再 重新 设置 天 counter 当 中 。 注 意 调用 LiveData 的 getValue() 方 法 所 获得 的 数据 是 可 能 为 空 
的 ， 因 此 这 里 使 用 了 一 个 ? :操作 符 ， 当 获取 到 的 数据 为 空 时 ， 就 用 0 来 作为 默认 计数 。 


这 样 我 们 就 借助 LiveData 将 MainViewModel 的 写法 改造 完了 ， 接 下 来 开始 改造 
MainActivity ,代码 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


plusOneBtn.setOnClickListener { 
viewModel .plusOne() 


clearBtn.setOnClickListener { 
viewModel .clear() 


viewModel .counter.observe(this, Observer { count -> 
infoText.text = count.toString() 
}) 
} 


override fun onPause() { 
super.onPause() 
sp.edit { 
putInt("count reserved", viewModel .counter.value ?: 0) 


} 


} 


很 显然 ， 在 “Plus One” 按 钮 的 点 击 事件 中 我 们 应 该 去 调用 MainViewModel 的 plusO0ne() 方 
法 , 而 在 “Clear” 按 钮 的 点 击 事件 中 应 该 去 调用 MainViewModel 的 clear( ) 方 法 。 另 外 ,在 
onPause() 方 法 中 ，, 我们 将 获取 当前 计数 的 写法 改造 了 一 下 ， 这 部 分 内 容 还 是 很 好 理解 的 。 


接 下 来 到 最 关键 的 地 方 了 ， 这 里 调用 了 viewModeL. counter 的 observe ( ) 方 法 来 观察 数据 的 
变化 。 经 过 对 MainViewModel 的 改造 ， 现 在 counter 变 量 已 经 变 成 了 一 个 LiveData 对 象 ， 任 
何 LiveData 对 象 都 可 以 调用 它 的 observe ( ) 方 法 来 观察 数据 的 变化 。observe ( ) 方 法 接收 两 
个 参数 : 第 一 个 参数 是 一 个 LifecyctLe0wner 对 象 , 有 没有 觉得 很 熟悉 ? 没 错 ，Activity 本 身 
就 是 一 个 LifecycLe0wner 对 象 ， 因 此 直接 传 this 就 好 ; 第 二 个 参数 是 一 个 Observer 接口 ， 
当 counter 中 包含 的 数据 发 生变 化 时 ， 就 会 回调 到 这 里 ， 因 此 我 们 在 这 里 将 最 新 的 计数 更 新 到 
界面 上 即 可 。 
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重新 运行 一 下 程序 ,你 会 发 现 ， 计 数 器 功能 同样 是 可 以 正常 工作 的 。 不 同 的 是 ， 现 在 我 们 的 代 
码 更 科学 ， 也 更 合理 ， 而且 不 用 担心 ViewModel 的 内 部 会 不 会 开启 线程 执行 耗 时 逻辑 。 不 过 需 
要 注意 的 是 ， 如 果 你 需要 在 子 线程 中 给 LiveData 设 置 数 据 ， 一定 要 调用 postValue() 方 法 ， 
而 不 能 再 使 用 setValue() 方 法 ， 否则 会 发 生 毅 溃 。 


另外 , 关于 LiveData 的 observe ( ) 方 法 ， 我 还 想 再 多 说 几 名 ， 因 为 我 当初 在 学 习 这 部 分 内 容 时 
也 产生 过 疑惑 。observe( ) 方 法 是 一 个 java 方 法 ,如果 你 观察 一 下 0bserver 接 口 ， 会 发 现 这 
是 一 个 单 抽象 方法 接口 ， 只 有 一 个 待 实现 的 onChanged ( ) 方 法 。 既 然 是 单 抽象 方法 接口 ， 为 什 
么 在 调用 observe ( ) 方 法 时 却 没有 使 用 我 们 在 2.6.3 小 节 学 习 的 java 函 数 式 API 的 写法 呢 ? 


这 是 一 种 非常 特殊 的 情况 ， 因 为 observe( ) 方 法 接收 的 另 一 个 参数 LifecycLe0wner 也 是 一 个 
单 抽象 方法 接口 。 当 一 个 Java 方法 同时 接收 两 个 单 抽象 方法 接口 参数 时 ， 要 么 同时 使 用 函数 式 
API 的 写法 ， 要么 都 不 使 用 函数 式 API 的 写法 。 由 于 我 们 第 一 个 参数 传 的 是 this , 因此 第 二 个 参 
数 就 无 法 使 用 函数 式 API 的 写法 了 。 


不 过 在 2019 年 的 Google VO 大 会 上 , Android 团 队 官 宣 了 Kotlin First ,并 且 承 诺 未 来 会 在 
jetpack 中 提供 更 多 专门 面向 Kotlin 语 言 的 API。 其 中 ,lifecycle-livedata-ktx 就 是 一 个 专门 为 
Kotlin 语 言 设计 的 库 ， 这 个 库 在 2.2.0 版 本 中 加 入 了 对 observe( ) 方 法 的 语法 扩展 。 我 们 只 需要 
在 app/build.gradle 文 件 中 添加 如 下 依赖 : 


dependencies { 


implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.2.0" 


} 


然后 就 可 以 使 用 如 下 语法 结构 的 observe() 方 法 了 : 


viewModel .counter.observe(this) { count -> 
infoText.text = count.toString() 
} 


以 上 就 是 LiveData 的 基本 用 法 。 虽 说 现在 的 写法 可 以 正常 工作 ,但 其 实 这 仍然 不 是 最 规范 的 
LiveData 用 法 ， 主 要 的 问题 就 在 于 我 们 将 counter 这 个 可 变 的 LiveData 暴 露 给 了 外 部 。 这 样 
即使 是 在 ViewModel 的 外 面 也 是 可 以 给 counter 设 置 数据 的 ， 从 而 破坏 了 ViewModel 数 据 的 
封装 性 ， 同 时 也 可 能 带 来 一 定 的 风险 。 


比较 推荐 的 做 法 是 ,永远 只 暴露 不 可 变 的 LiveData 给 外 部 。 这 样 在 非 ViewModel 中 就 只 能 观察 
LiveData 的 数据 变化 ， 而 不 能 给 LiveData 设 置 数据 。 下 面 我 们 就 看 一 下 如 何 改造 
MainViewModel 来 实现 这 样 的 功能 : 


class MainViewModel (countReserved: Int) : ViewModel() { 


val counter: LiveData<Int> 
get() = counter 


private val counter = MutableLiveData<Int>() 
init { 


_Ccounter.value = countReserved 


} 
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fun plusOne() { 
val count = counter.value ?: 0 
_Ccounter.value = count + 1 


} 


fun clear() { 
_Ccounter.value = 0 
} 


} 


可 以 看 到 ， 这 里 先 将 原来 的 counter 变 量 改名 为 _counter 变 量 ， 并 给 它 加 上 private 修 饰 
符 , 这 样 _counter 变 量 对 于 外 部 就 是 不 可 见 的 了 。 然 后 我 们 又 新 定义 了 一 个 counter 变 量 ， 
将 它 的 类 型 声明 为 不 可 变 的 LiveData , 并 在 它 的 get ( ) 属性 方法 中 返回 _counter 变 量 。 


这 样 ， 当 外 部 调用 counter 变 量 时 ， 实 际 上 获得 的 就 是 _counter 的 实例 ， 但 是 无 法 给 
counter 设 置 数据 ， 从 而 保证 了 ViewModel 的 数据 封装 性 。 


目前 这 种 写法 可 以 说 是 非常 规范 了 ， 这 也 是 Android 官 方 最 为 推荐 的 写法 ， 希 望 你 能 好 好 掌握 。 
13.4.2 map 和 switchMap 

LiveData 的 基本 用 法 虽说 可 以 满足 大 部 分 的 开发 需求 ,但 是 当 项 目 变 得 复杂 之 后 ， 可 能 会 出 现 
一 些 更 加 特殊 的 需求 。LiveData 为 了 能 够 应 对 各 种 不 同 的 需求 场景 ， 提供 了 两 种 转换 方法 : 
map() 和 switchMap ( ) 方 法 。 下 面 我 们 就 学 习 这 两 种 转换 方法 的 具体 用 法 和 使 用 场景 。 


先 来 看 map ( ) 方法， 这 个 方法 的 作用 是 将 实际 包含 数据 的 LiveData 和 仅 用 于 观察 数据 的 
LiveData 进 行 转换 。 那 么 什么 情况 下 会 用 到 这 个 方法 呢 ? 下 面 我 来 举 一 个 例子 。 


比如 说 有 一 个 User 类 ，User 中 包含 用 户 的 姓名 和 年 龄 ， 定 义 如 下 : 


data class User(var firstName: String, var LastName: String, var age: Int) 


我 们 可 以 在 ViewModel 中 创建 一 个 相应 的 LiveData 来 包含 User 类 型 的 数据 ， 如 下 所 示 : 


class MainViewModel (countReserved: Int) : ViewModel() { 


val userLiveData = MutableLiveData<User>() 


} 


到 目前 为 止 ， 这 和 我 们 在 上 一 小 节 中 学 习 的 内 容 并 没有 什么 区 别 。 可 是 如 果 MainActivity 中 明 
只 会 显示 用 户 的 姓名 ， 而 完全 不 关心 用 户 的 年 龄 ， 那 么 这 个 时 候 还 将 整个 User 类 型 的 
LiveData 暴 露 给 外 部 ， 就 显得 不 那么 合 到 了 。 


而 map ( ) 方 法 就 是 专门 用 于 解决 这 种 问题 的 ， 它 可 以 将 User 类 型 的 LiveData 自 由 地 转型 成 任意 
其 他 类 型 的 LiveData ,下 面 我 们 来 看 一 下 具体 的 用 法 : 


class MainViewModel (countReserved: Int) : ViewModel() { 


private val userLiveData = MutableLiveData<User>() 
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val userName: LiveData<String> = Transformations ,map(userLiveData) { user -> 
"${user.firstName} ${user.lastName}" 


} 


可 以 看 到 ， 这 里 我 们 调用 了 Transformations 的 map ( ) 方 法 来 对 LiveData 的 数据 类 型 进行 转 
换 。map ( ) 方 法 接收 两 个 参数 : 第 一 个 参数 是 原始 的 LiveData 对 象 ; 第 二 个 参数 是 一 个 转换 函 
数 ， 我们 在 转换 函数 里 编写 具体 的 转换 逻辑 即 可 。 这 里 的 逻辑 也 很 简单 ， 就 是 将 User 对 象 转换 
成 一 个 只 包含 用 户 姓名 的 字符 串 。 


另外 ,我 们 还 将 userLiveData 声 明成 了 private ,以 保证 数据 的 封装 性 。 外 部 使 用 的 时 候 只 
要 观察 userName 这 个 LiveData 就 可 以 了 。 当 userLiveData 的 数据 发 生变 化 时 ,map ( ) 方 法 
会 监听 到 变化 并 执行 转换 函数 中 的 逻辑 ， 然 后 再 将 转换 之 后 的 数据 通知 给 userName 的 观察 者 。 


这 就 是 map ( ) 方 法 的 用 法 和 使 用 场景 ， 非常 好 理解 。 


接 下 来 ， 我 们 开始 学 习 switchMap ( ) 方 法 ， 虽 然 它 的 使 用 场景 非常 固定 ， 但 是 可 能 比 map ( ) 方 
法 要 更 加 常用 。 


前 面 我 们 所 学 的 所 有 内 容 都 有 一 个 前 提 : LiveData 对 象 的 实例 都 是 在 ViewModel 中 创建 的 。 然 
而 在 实际 的 项 目 中 ， 不 可 能 一 直 是 这 种 理想 情况 ， 很 有 可 能 ViewModel 中 的 某 个 LiveData 对 象 
是 调用 另外 的 方法 获取 的 。 
下 面 就 来 模拟 一 下 这 种 情况 ， 新 建 一 个 Repository 单 例 类 ， 代码 如 下 所 示 : 
object Repository { 
fun getUser(userId: String): LiveData<User> { 
val liveData = MutableLiveData<User>() 


liveData.value = User(userId, userId, 0) 
return liveData 


} 


这 里 我 们 在 Repository 类 中 添加 了 一 个 getUser() 方 法 ,这 个 方法 接收 一 个 userId 参 数 。 
按照 正常 的 编程 逻辑 ， 我 们 应 该 根据 传 入 的 userId 参 数 去 服务 器 请 求 或 者 到 数据 库 中 查找 相应 
的 User 对 象 , 但 是 这 里 只 是 模拟 示例 ， 因 此 每 次 将 传 入 的 userId 当 作用 户 姓名 来 创建 一 个 新 
的 User 对 象 即 可 。 


需要 注意 的 是 , getUser( ) 方 法 返回 的 是 一 个 包含 User 数 据 的 LiveData 对 象 ， 而 且 每 次 调用 
getUser () 方 法 都 会 返回 一 个 新 的 LiveData 实 例 。 


然后 我 们 在 MainViewModel 中 也 定义 一 个 getUser ( ) 方 法 ， 并 且 让 它 调用 Repository 的 
getUser() 方 法 来 获取 LiveData 对 和 象 : 


class MainViewModel (countReserved: Int) : ViewModel() { 


fun getUser(userId: String): LiveData<User> { 
return Repository.getUser(userId) 
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} 
} 


接 下 来 的 问题 就 是 ， 在 Activity 中 如 何 观 察 LiveData 的 数据 变化 呢 ? 既然 getUser() 方 法 返回 
的 就 是 一 个 LiveData 对 象 ， 那 么 我 们 可 不 可 以 直接 在 Activity 中 使 用 如 下 写法 呢 ? 


viewModel .getUser(userId).observe(this) { user -> 


请 注意 ， 这 么 做 是 完全 错误 的 。 因 为 每 次 调用 getUser( ) 方 法 返回 的 都 是 一 个 新 的 LiveData 实 
例 ， 而 上 述 写 法 会 一 直观 察 老 的 LiveData 实 例 ， 从 而 根本 无 法 观察 到 数据 的 变化 。 你 会 发 现 ， 
这 种 情况 下 的 LiveData 是 不 可 观察 的 。 


这 个 时 候 ， switchMap ( ) 方 法 就 可 以 派 上 用 场 了 。 正 如 前 面 所 说 , 它 的 使 用 场景 非常 固定 : 如 
果 ViewModel 中 的 某 个 LiveData 对 象 是 调用 另外 的 方法 获取 的 ， 那 么 我 们 就 可 以 借助 
SwitchMap () 方 法 ， 将 这 个 LiveData 对 象 转换 成 另外 一 个 可 观察 的 LiveData 对 象 。 


修改 MainViewModel 中 的 代码 ， 如 下 所 示 : 


class MainViewModel (countReserved: Int) : ViewModel() { 
private val userIdLiveData = MutableLiveData<String>() 
val user: LiveData<User> = Transformations.switchMap(userIdLiveData) { userId -> 


Repository.getUser(userId ) 


fun getUser(userId: String) { 
userIdLiveData.value = USerId 
} 


} 


这 里 我 们 定义 了 一 个 新 的 userIdLiveData 对 象 ,用 来 观察 userId 的 数据 变化 ， 然 后 调用 了 
Transformations 的 SwitchMap () 方 法 ,用 来 对 另 一 个 可 观察 的 LiveData 对 象 进行 转换 。 


switchMap ( ) 方 法 同样 接收 两 个 参数 : 第 一 个 参数 传 入 我 们 新 增 的 userIdLiveData ， 
SwitchMap ( ) 方 法 会 对 它 进 行 观察 ; 第 二 个 参数 是 一 个 转换 函数 ， 注 意 ， 我 们 必须 在 这 个 转换 
六 数 中 返回 一 个 LiveData 对 象 ， 因 为 switchMap() 方 法 的 工作 原理 就 是 要 将 转换 水 数 中 返回 
的 LiveData 对 象 转换 成 另 一 个 可 观察 的 LiveData 对 象 。 那 么 很 显然 ， 我 们 只 需要 在 转换 函数 中 
调用 Repository 的 getUser ( ) 方 法 来 得 到 LiveData 对 象 ， 并 将 它 返 回 就 可 以 了 。 


为 了 让 你 能 更 清晰 地 理解 SwitchMap ( ) 的 用 法 ， 我 们 再 来 梳理 一 遍 它 的 整体 工作 流程 。 首 先 ， 
当 外 部 调用 MainViewModel 的 getUser( ) 方 法 来 获取 用 户 数据 时 ， 并 不 会 发 起 任何 请 求 或 者 
函数 调用 ， 只 会 将 传 入 的 userId 值 设置 到 userIdLiveData 当 中 。 一 旦 userIdLiveData 的 
数据 发 生变 化 ， 那 么 观察 userIdLiveData 的 SwitchMap () 方 法 就 会 执行 ， 并 且 调 用 我 们 编 
与 的 转换 函数 。 然 后 在 转换 函数 中 调用 Repository .getUser() 方 法 获取 真正 的 用 户 数 据 。 
同时 ， switchMap() 方 法 会 将 Repository .getUser() 方 法 返回 的 LiveData 对 象 转换 成 一 
个 可 观察 的 LiveData 对 象 ， 对 于 Activity 而 言 ， 只 要 去 观察 这 个 LiveData 对 象 就 可 以 了 。 


下 面 我 们 就 来 测试 一 下 ， 修改 activity_main.xml 文 件 ,在 里 面 新 增 一 个 “Get User "按钮 : 
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<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:id="@+id/getUserBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Get User"/> 
</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


getUserBtn.setOnClickListener { 
val userId = (0..10000).random().toString() 
viewModel .getUser(userlId) 

} 

viewModel .user.observe(this, Observer { user -> 
infoText.text = user.firstName 

}) 


} 


具体 的 用 法 就 是 这 样 了 ， 我们 在 “Get User" 按 钮 的 点 击 事件 中 使 用 随机 函数 生成 了 一 个 
userId , 然后 调用 MainViewModel 的 getUser ( ) 方 法 来 获取 用 户 数据 ,但 是 这 个 方法 现在 不 
会 有 任何 返回 值 了 。 等 数据 获取 完成 之 后 ,可 观察 LiveData 对 象 的 observe ( ) 方 法 将 会 得 到 通 
知 ,我们 在 这 里 将 获取 的 用 户 名 显示 到 界面 上 。 


现在 重新 运行 程序 ， 并 一 直 点 击 “Get User" 按 钮 ,你 会 发 现 界面 上 的 数字 会 一 直 在 变 ,如 图 
13.9 所 示 。 这 是 因为 我 们 传 入 的 userId 值 是 随机 的 ， 同 时 也 说 明 switchMap ( ) 方 法 确实 已 经 
正常 工作 了 。 
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图 13.9 ”数字 会 在 0 到 10 000 之 间 随 机 变化 
最 后 再 介绍 一 个 我 当初 学 习 switchMap ( ) 方 法 时 产生 疑惑 的 地 方 。 在 刚才 的 例子 当中 ， 我们 调 


JJ = 
用 MainViewModel 的 getUser ( ) 方 法 时 传 入 了 一 个 userId 参 数 ， 为 了 能 够 观察 这 个 参数 的 数 
据 变 化 , 又 构建 了 一 个 userIdLiveData , 然后 在 switchMap ( ) 方 法 中 再 去 观察 这 个 
LiveData 对 象 就 可 以 了 。 但 是 ViewModetL 中 某 个 获取 数据 的 方法 有 可 能 是 没有 参数 的 ， 这 个 时 


候 代码 应 该 怎么 写 呢 ? 


其 实 这 个 问题 并 没有 想象 中 复杂 ， 写法 基本 上 和 原来 是 相同 的 ， 只 是 在 没有 可 观察 数据 的 情况 
下 ， 我 们 需要 创建 一 个 空 的 LiveData 对 象 ， 示 例 写 法 如 下 : 


class MyViewModel : ViewModel() { 


private val refreshLiveData = MutabLeLiveData<Any?>() 


val refreshResult = Transformations.switchMap(refreshLiveData) { 
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Repository.refresh() // 假设 Repository 中 已 经 定义 了 refresh ( ) 方 法 


fun refresh() { 
refreshLiveData.value = refreshLiveData.value 


} 


} 


可 以 看 到 ,这 里 我 们 定义 了 一 个 不 带 参 数 的 refresh ( ) 方 法 ， 又 对 应 地 定义 了 一 个 
refreshLiveData , 但 是 它 不 需要 指定 具体 包含 的 数据 类 型 ， 因 此 这 里 我 们 将 LiveData 的 泛 
型 指定 成 Any? 即 可 。 


接 下 来 就 是 点 睛 之 笔 的 地 方 了 ,在 refresh( ) 方 法 中 ,我 们 只 是 将 refreshLiveData 原 有 的 
数据 取出 来 (默认 是 空 ) ， 再 重新 设置 到 refreshLiveData 当 中 ,这样 就 能 触发 一 次 数据 变 
化 。 是 的 ，LiveData 内 部 不 会 判断 即将 设置 的 数据 和 原 有 数据 是 否 相 同 ， 只 要 调用 了 
setValue() 或 postValue() 方 法 ,就 一 定 会 触发 数据 变化 事件 。 


然后 我 们 在 Activity 中 观察 ref reshResult 这 个 LiveData 对 象 即 可 ， 这 样 只 要 调用 了 
refresh ( ) 方 法 ,观察 者 的 回调 函数 中 就 能 够 得 到 最 新 的 数据 。 


可 能 你 会 说 ,学 到 现在 , 只 看 到 了 LiveData 与 ViewModel 结 合 在 一 起 使 用 ,好像 和 我 们 上 一 节 
学 的 Lifecycles 组 件 没什么 关系 嘛 。 


其 实 并 不 是 这 样 的 ，LiveData 之 所 以 能 够 成 为 Activity 与 ViewModel 之 间 通 信和 的 桥梁 ， 并且 还 
不 会 有 内 存 泄漏 的 风险 ， 靠 的 就 是 Lifecycles 组 件 。LiveData 在 内 部 使 用 了 Lifecycles 组 件 来 
自我 感知 生命 周期 的 变化 ， 从 而 可 以 在 Activity 销 毁 的 时 候 及 时 释放 引用 ， 避 免 产 生 内 存 泄漏 的 
问题 。 

另外 ， 由 于 要 减少 性 能 消耗 ， 当 Activity 处 于 不 可 见 状 态 的 时 候 (比如 手机 息 屏 , 或 者 被 其 他 的 
Activity 和 遮挡) ， 如 果 LiveData 中 的 数据 发 生 了 变化 ， 是 不 会 通知 给 观察 者 的 。 只 有 当 Activity 
重新 恢复 可 见 状 态 时 ， 才 会 将 数据 通知 给 观察 者 ， 而 LiveData 之 所 以 能 够 实现 这 种 细节 的 优 
化 ， 依 靠 的 还 是 Lifecycles 组 件 。 

还 有 一 个 小 细节 ， 如 果 在 Activity 处 于 不 可 见 状 态 的 时 候 ，LiveData 发 生 了 多 次 数据 变化 ， 当 
Activity 恢 复 可 见 状态 时 ， 只 有 最 新 的 那 份 数 据 才 会 通知 给 观察 者 ， 前面 的 数据 在 这 种 情况 下 相 
当 于 已 经 过 期 了 ， 会 被 直接 丢弃 。 


到 这 里 ， 我 们 基本 上 就 将 LiveData 相 关 的 所 有 重要 内 容 都 学 完了 。 
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13.5 Room 


在 第 7 章 的 时 候 我 们 学 习 了 SQLite 数 据 库 的 使 用 方法 ， 不 过 当时 仅仅 是 使 用 了 一 些 原生 的 APl 来 
进行 数据 的 增删 改 查 操作 。 这 些 原 生 API 虽 然 简单 易 用 ， 但 是 如 果 放 到 大 型 项 目 当中 的 话 ， 会 非 
常 容易 让 项 目的 代码 变 得 混乱 ， 除 非 你 进行 了 很 好 的 封装 。 为 此 市 面 上 出 现 了 诸多 专门 为 
Android 数 据 库 设计 的 ORM 框 架 。 


ORM (Object Relational Mapping) 也 叫 对 象 关系 映射 。 简 单 来 讲 ， 我 们 使 用 的 编程 语言 是 
面向 对 象 语言 ， 而 使 用 的 数据 库 则 是 关系 型 数据 库 ， 将 面向 对 象 的 语言 和 面向 关系 的 数据 库 之 
间 建立 一 种 映射 关系 ， 这 就 是 ORM 了 。 


那么 使 用 ORM 框 架 有 什么 好 处 呢 ? 它 赋予 了 我 们 一 个 强大 的 功能 ， 就 是 可 以 用 面向 对 象 的 思维 
来 和 数据 库 进 行 交 互 ， 绝 大 多 数 情 况 下 不 用 再 和 SQL 语句 打交道 了 ， 同 时 也 不 用 担心 操作 数据 
库 的 逻辑 会 让 项 目的 整体 代码 变 得 混乱 。 


由 于 许多 大 型 项 目 中 会 用 到 数据 库 的 功能 ,为 了 帮助 我 们 编写 出 更 好 的 代码 ，Android 官 方 推出 
了 一 个 ORM 框 架 ， 并 将 已 加 入 了 jetpack 当 中 ， 就 是 我 们 这 节 即将 学 习 的 Room。 


13.5.1 使 用 Room 进行 增删 改 查 


那么 现在 就 开始 吧 ， 先 来 看 一 下 Room 的 整体 结构 。 它 主要 由 Entity、Dao 和 Database 这 3 部 
分 组 成 ， 每 个 部 分 都 有 明确 的 职责 ， 详 细 说 明 如 下 。 


。Entity。 用 于 定义 封装 实际 数据 的 实体 类 ， 每 个 实体 类 都 会 在 数据 库 中 有 一 张 对 应 的 表 ,并 
且 表 中 的 列 是 根据 实体 类 中 的 字段 自动 生成 的 。 

。 Dao。Dao 是 数据 访问 对 象 的 意思 ， 通 常会 在 这 里 对 数据 库 的 各 项 操作 进行 封装 ， 在 实际 
编程 的 时 候 ， 逮 辑 层 就 不 需要 和 底层 数据 库 打 交道 了 ， 直接 和 Dao 层 进行 交互 即 可 。 

。Database。 用 于 定义 数据 库 中 的 关键 信息 ， 包 括 数 据 库 的 版 本 号 、 包 含 哪些 实体 类 以 及 提 
供 Dao 层 的 访问 实例 。 


不 过 只 看 这 些 概念 可 能 还 是 不 太 容易 理解 ， 下面 我 们 结合 实践 来 学 习 一 下 Room 的 具体 用 法 。 
继续 在 JetpackTest 项 目 上 进行 改造 。 首 先 要 使 用 Room , 需要 在 app/build.gradle 文 件 中 添加 
如 下 的 依赖 : 


apply plugin: 'com.android.application' 
apply plugin: 'kotlin-android' 

apply plugin: 'kotlin-android-extensions' 
apply plugin: "kotLin-kapt' 


dependencies { 


implementation "androidx.room:room-runtime:2.1.0" 
kapt "androidx.room:room-compiler:2.1.0" 


} 


这 里 新 增 了 一 个 kotlin-kapt 插 件 ， 同 时 在 dependencies 闭 包 中 添加 了 两 个 Room 的 依赖 库 。 
由 于 Room 会 根据 我 们 在 项 目 中 声明 的 注解 来 动态 生成 代码 ， 因 此 这 里 一 定 要 使 用 kapt 引 入 
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Room 的 编译 时 注解 库 ,而 局 用 编译 时 注解 功能 则 一 定 要 先 添加 Kotlin-kapt 插 件 。 注 意 ，Kkapt 
只 能 在 Kotlin 项 目 中 使 用 ， 如 果 是 java 项 目的 话 ， 使 用 annotationProcessor 即 可 。 


下 面 我 们 就 按照 刚才 介绍 的 Room 的 3 个 组 成 部 分 一 一 来 进行 实现 ， 首 先是 定义 Entity，, 也 就 
是 实体 类 。 


好 消息 是 JetpackTest 项 目 中 已 经 存在 一 个 实体 类 了 ， 就 是 我 们 在 学 习 LiveData 时 创建 的 User 
类 。 然 而 User 类 目前 只 包含 firstName、LastName 和 age 这 3 个 字段 ， 但 是 一 个 良好 的 数据 
库 编 程 建议 是 ， 给 每 个 实体 类 都 添加 一 个 id 字段 ， 并 将 这 个 字段 设 为 主键 。 于 是 我 们 对 User 类 
进行 如 下 改造 ， 并 完成 实体 类 的 声明 : 


@Entity 
data class User(var firstName: String, var lastName: String, var age: Int) { 


@PrimaryKey(autoGenerate = true) 
var id: Long = 0 


} 


可 以 看 到 ， 这 里 我 们 在 User 的 类 名 上 使 用 GEntity 注 解 ， 将 它 声明 成 了 一 个 实体 类 ， 然 后 在 
User 类 中 添加 了 一 个 id 字段 ， 并 使 用 GPrimaryKey 注 解 将 它 设 为 了 主键 ， 再 把 
autoGenerate 参 数 指定 成 true , 使 得 主键 的 值 是 自动 生成 的 。 


这 样 实体 类 部 分 就 定义 好 了 ， 不 过 这 里 简单 起 见 ， 只 定义 了 一 个 实体 类 , 在 实际 项 目 当 中 ， 你 
可 能 需要 根据 具体 的 业务 逻辑 定义 很 多 个 实体 类 。 当 然 ， 每 个 实体 类 定义 的 方式 都 是 差不多 
的 ， 最 多 添加 一 些 实体 类 之 间 的 关联 。 


接 下 来 开始 定义 Dao ,这 部 分 也 是 Room 用 法 中 最 关键 的 地 方 ， 因 为 所 有 访问 数据 库 的 操作 都 是 
在 这 里 封装 的 。 


通过 第 7 章 的 学 习 我 们 已 经 了 解 到 ， 访问 数据 库 的 操作 无 非 就 是 增删 改 查 这 4 种 ， 但 是 业务 需求 
却 是 干 变 万 化 的 。 而 Dao 要 做 的 事情 就 是 覆盖 所 有 的 业务 需求 ， 使 得 业务 方 永 远 只 需要 与 Dao 
层 进 行 交 互 ， 而 不 必 和 底 层 的 数据 库 打 交道 。 


那么 下 面 我 们 就 来 看 一 下 一 个 Dao 具 体 是 如 何 实现 的 。 新 建 一 个 UserDao 接 口 ， 注 意 必须 使 用 
接口 ， 这 点 和 Retrofit 是 类 似 的 ， 然 后 在 接口 中 编写 如 下 代码 : 


GDao 
interface UserDao { 


@Insert 
fun insertUser(user: User): Long 


@Update 
fun updateUser (newUser: User) 


@Query("select * from User") 
fun loadAllUsers(): List<User> 


@Query("select * from User where age > :age") 
fun loadUsersOlderThan(age: Int): List<User> 


GDetLete 
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fun deleteUser(user: User) 


@Query("delete from User where LastName = :lastName") 
fun deleteUserByLastName(lastName: String): Int 


} 


UserDao 接 口 的 上 面 使 用 了 一 个 GDao 注 解 ， 这 样 Room 才 能 将 它 识别 成 一 个 Dao。UserDao 的 
内 部 就 是 根据 业务 需求 对 各 种 数据 库 操 作 进 行 的 封装 。 数 据 库 操 作 通 常 有 增删 改 查 这 4 种 ， 因 此 
Room 也 提供 了 QInsert、G@DetLete、G@Update 和 QQuery 这 4 种 相应 的 注解 。 


可 以 看 到 ,insertUser() 方 法 上 面 使 用 了 QInsert 注 解 ， 表 示 会 将 参数 中 传 入 的 User 对 象 插 
入 数据 库 中 ， 插入 完成 后 还 会 将 自动 生成 的 主键 id 值 返回 。updateUser() 方 法 上 面 使 用 了 
GUpdate 注 解 ， 表 示 会 将 参数 中 传 入 的 User 对 象 更 新 到 数据 库 当 中 。deLeteUser( ) 方 法 上 面 
使 用 了 GDetLete 注 解 ， 表 示 会 将 参数 传 入 的 User 对 象 从 数据 库 中 删除 。 以 上 几 种 数据 库 操 作 都 
是 直接 使 用 注解 标识 即 可 ， 不 用 编写 SQL 语句 。 


但 是 如 果 想 要 从 数据 库 中 查询 数据 ， 或 者 使 用 非 实体 类 参数 来 增删 改 数据 ， 那么 就 必须 编写 
SQL 语句 了 。 比 如 说 我 们 在 UserDao 接 口中 定义 了 一 个 LoadALLUsers () 方 法 ， 用 于 从 数据 库 
中 查询 所 有 的 用 户 ， 如 果 只 使 用 一 个 QQuery 注 解 ，Room 将 无 法 知道 我 们 想 要 查询 哪些 数据 ， 
因此 必须 在 GQue ry 注 解 中 编写 具体 的 SQL 语句 才 行 。 我 们 还 可 以 将 方法 中 传 入 的 参数 指定 到 
SQL 语句 当中 ,比如 LoadUsers0LderThan ( ) 方 法 就 可 以 查询 所 有 年 龄 大 于 指定 参数 的 用 

户 。 另 外 ， 如 果 是 使 用 非 实 体 类 参数 来 增删 改 数据 ， 那 么 也 要 编写 SQL 语句 才 行 ， 而 且 这 个 时 
候 不 能 使 用 GInsert、@DetLete 或 GUpdate 注 解 ， 而 是 都 要 使 用 GQQue ry 注 解 才 行 ， 参 考 
deleteUserByLastName() 方 法 的 写法 。 


这 样 我 们 就 大 体 定 义 了 添加 用 户 、 修 改 用 户 数据 、 查 询 用 户 、 删 除 用 户 这 几 种 数据 库 操作 接 
口 ， 在 实际 项 目 中 你 根据 真实 的 业务 需求 来 进行 定义 即 可 。 


虽然 使 用 Room 需要 经 常 编写 SQL 语句 这 一 点 不 太 友 好 ， 但 是 SQL 语句 确实 可 以 实现 更 加 多 样 化 
的 逻辑 ， 而且 Room 是 支持 在 编译 时 动态 检查 SQL 语 名 语法 的 。 也 就 是 说 ， 如果 我 们 编写 的 SQL 
语句 有 语法 错误 ， 编 译 的 时 候 就 会 直接 报错 ， 而 不 会 将 错误 隐藏 到 运行 的 时 候 才 发 现 ， 也 算是 
大 大 减少 了 很 多 安全 隐患 吧 。 

接 下 来 我 们 进入 最 后 一 个 环节 : 定义 Database。 这 部 分 内 容 的 写法 是 非常 固定 的 ， 只 需要 定义 
好 3 个 部 分 的 内 容 : 数据 库 的 版 本 号 、 包 含 哪些 实体 类 ， 以 及 提供 Dao 层 的 访问 实例 。 新 建 一 个 
AppDatabase.kt 文 件 ,代码 如 下 所 示 : 


GDatabase(version = 1, entities = [User::class]) 
abstract class AppDatabase : RoomDatabase() { 


abstract fun userDao(): UserDao 

companion object { 
private var instance: AppDatabase? = null 
@Synchronized 
fun getDatabase(context: Context): AppDatabase { 


instance?.let { 
return it 
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} 

return Room.databaseBuilder(context.applicationContext, 
AppDatabase: :class.java, "app database") 
.build().apply { 
instance = this 


} 


可 以 看 到 , 这 里 我 们 在 AppDatabase 类 的 头 部 使 用 了 @Database 注 解 ， 并 在 注解 中 声明 了 数 
据 库 的 版 本 号 以 及 包含 哪些 实体 类 ， 多 个 实体 类 之 间 用 如 号 隔 开 即 可 。 


另外 ,AppDatabase 类 必须 继承 自 RoomDatabase 类 ， 并 且 一 定 要 使 用 abst ract 关 键 字 将 它 
声明 成 抽象 类 ， 然 后 提供 相应 的 抽象 方法 ， 用 于 获取 之 前 编写 的 Dao 的 实例 ， 比 如 这 里 提供 的 

userDao( ) 方 法 。 不 过 我 们 只 需要 进行 方法 声明 就 可 以 了 ， 具 体 的 方法 实现 是 由 Room 在 底层 
自动 完成 的 。 


紧 接 着 ， 我 们 在 companion object 结 构 体 中 编写 了 一 个 单 例 模式 ， 因 为 原则 上 全 局 应 该 只 存 
在 一 份 AppDatabase 的 实例 。 这 里 使 用 了 instance 变 量 来 缓存 AppDatabase 的 实例 ， 然后 
在 getDatabase() 方 法 中 判断 : 如 果 instance 变 量 不 为 空 就 直接 返回 ， 否则 就 调用 
Room.databaseBuilder() 方 法 来 构建 一 个 AppDatabase 的 实例 。databaseBuilder() 
方法 接收 3 个 参数 ， 注意 第 一 个 参数 一 定 要 使 用 appLicationContext， 而 不 能 使 用 普通 的 
context ， 
在 第 14 章 中 学 习 。 第 二 个 参数 是 AppDatabase 的 CLass 类 型 ， 第 三 个 参数 是 数据 库 名 ， 这 些 都 
比较 简单 。 最 后 调用 bUitd () 方法 完成 构建 ， 并 将 创 | 建 出 来 的 实例 荆 们 给 instance 变 量 , 然 
后 返回 当前 实例 即 可 。 


这 样 我 们 就 把 Room 所 需要 的 一 切 都 定义 好 了 ， 接 下 来 要 做 的 事情 就 是 对 它 进 行 测试 。 修 改 
activity_ main.xml 中 的 代码 ， 在 里 面 加 入 用 于 增删 改 查 的 4 个 按钮 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:id="@+id/getUserBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:Layout gravity="center horizontal" 
android:text="Get User"/> 


<Button 
android:id="@+id/addDataBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:Layout gravity="center horizontal" 
android:text="Add Data"/> 


<Button 
android:id="@+id/updateDataBtn" 
android:layout width="match parent" 
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android:Layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Update Data"/> 


<Button 
android:id="@+id/deleteDataBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Delete Data"/> 


<Button 
android:id="@+id/queryDataBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:Layout gravity="center horizontal" 
android:text="Query Data"/> 
</LinearLayout> 


然后 修改 MainActivity 中 的 代码 ,分别 在 这 4 个 按钮 的 点 击 事件 中 实现 增删 改 查 的 逻辑 ,如 下 所 


小 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 
val userDao = AppDatabase.getDatabase(this).userDao() 
val userl User("Tom", "Brady", 40) 
val user2 User("Tom", "Hanks", 63) 
addDataBtn.setOnClickListener { 
thread { 
userl.id 
user2.id 


= USerDao.insertUser(user1) 
= UserDao.insertUser(user2) 
} 
} 
updateDataBtn.setOnClickListener { 
thread { 
userl.age = 42 
userDao.updateUser(user]l) 


} 


} 
deleteDataBtn.setOnClickListener { 
thread { 
userDao.deleteUserByLastName ("Hanks") 
} 


} 
queryDataBtn.setOnClickListener { 
thread { 
for (user in userDao.loadAllUsers()) { 
Log.d("MainActivity", user.toString()) 
} 


这 段 代 码 的 逻辑 还 是 很 简单 的 。 首 先 获 取 了 UserDao 的 实例 ， 并 创建 两 个 User 对 象 。 然 后 
在 “Add Data" 按 钮 的 点 击 事件 中 ， 我 们 调用 了 UserDao 的 insertUser() 方 法 ,将 这 两 个 
User 对 象 插入 数据 库 中 ， 并 将 insertUser() 方 法 返回 的 主键 id 值 赋值 给 原来 的 User 对 象 。 
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之 所 以 要 这 么 做 ， 是 因为 使 用 @Update 和 @Delete 注 解 去 更 新 和 删除 数据 时 都 是 基于 这 个 id 值 
来 操作 的 。 


然后 在 “Update Data" 按 钮 的 点 击 事件 中 ， 我 们 将 user1 的 年 龄 修改 成 了 42 岁 ， 并 调用 
UserDao 的 updateUser( ) 方 法 来 更 新 数据 库 中 的 数据 。 在 “Delete Data" 按 钮 的 点 击 事 件 
中 ， 我 们 调用 了 UserDao 的 deLeteUserByLastName () 方 法 ,删除 所 有 lastName 是 Hanks 
的 用 户 。 在 “Query Data" 按 钮 的 点 击 事件 中 ,我们 调用 了 UserDao 的 LoadALLUsers ( ) 方 
法 ， 查 询 并 打印 数据 库 中 所 有 的 用 户 。 


另外 ， 由 于 数据 库 操 作 属于 耗 时 操作 ，Room 默 认 是 不 允许 在 主线 程 中 进行 数据 库 操作 的 ， 因 此 
上 述 代码 中 我 们 将 增删 改 查 的 功能 都 放 到 了 子 线程 中 。 不 过 为 了 方便 测试 ， Room 还 提供 了 一 个 
更 加 简单 的 方法 ， 如 下 所 示 : 


Room.databaseBuilder(context.applicationContext, AppDatabase: :class.java,"app database") 
.allowMainThreadQueries() 
.build() 


在 构建 AppDatabase 实 例 的 时 候 ， 加 入 一 个 aLlowMainThreadQueries() 方 法 ,这样 Room 
就 允许 在 主线 程 中 进行 数据 库 操作 了 ， 这 个 方法 建议 只 在 测试 环境 下 使 用 。 


好 了 ， 现 在 可 以 运行 一 下 程序 了 ， 界面 如 图 13.10 所 示 
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10:55 


JetpackTest 


0 


PLUS ONE 
CLEAR 
GET USER 
ADD DATA 
UPDATE DATA 
DELETE DATA 


QUERY DATA 


图 13.10 增加 了 增删 改 查 按钮 的 界面 


然后 点 击 “Add Data” 按 钮 ,再 点 击 “Query Data” 按 钮 , 查看 Logcat 中 的 打印 日 志 , 如 图 
13.11 所 示 。 


一 


com.example.jetpacktest (7777) v Verbose “ 豆 


57/com.example.jetpacktest D/MainActivity: User(firstName=Tom, lastName=Brady, age=40) 
57/com.example.jetpacktest D/MainActivity: User(firstName=Tom, lastName=Hanks, age=63) 


图 13.11 查询 并 打印 数据 库 中 的 数据 
由 此 可 以 证 明 ,两 条 用 户 数据 都 已 经 被 成 功 插入 数据 库 当 中 了 。 


接 下 来 点 击 “Update Data" 按 钮 ， 再 重新 点 击 ^“Query Data” 按 钮 ，Logcat 中 的 打印 日 志 如 图 
13.12 所 示 。 
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com.example.jetpacktest (7777) 性 Verbose “地 


33/com.example.jetpacktest D/MainActivity: User(firstName=Tom, lastName=Brady, age=42) 
33/com.example.jetpacktest D/MainActivity: User(firstName=Tom, lastName=Hanks, age=63) 


图 13.12 查询 并 打印 更 新 后 的 数据 
可 以 看 到 ,第 一 条 数据 中 用 户 的 年 龄 被 成 功 修改 成 了 42 岁 。 


最 后 点 击 “Delete Data" 按 钮 ， 再 次 点 击 “Query Data" 按 钮 ，Logcat 中 的 打印 日 志 如 图 
13.13 所 示 。 


com.example.jetpacktest (7777) v Verbose “ 忌 


17/com.example. jetpacktest D/MainActivity: User(firstName=Tom, lastName=Brady, age=42) 


图 13.13 ”查询 并 打印 删除 后 的 数据 
可 以 看 到 ， 现 在 只 剩 下 一 条 用 户 数据 了 。 


将 Room 的 用 法 体验 一 遍 之 后 ， 不 知道 你 有 什么 感觉 呢 ? 或 许 你 会 觉得 Room 使 用 起 来 太 过 于 烦 
琐 ， 要 先 定义 Entity ,再 定义 Dao，, 最 后 定义 Database， 还 不 如 直接 使 用 原生 的 
SQLiteDatabase 来 得 方便 。 但 是 你 有 没有 察觉 ， 一旦 将 上 述 3 部 分 内 容 都 定义 好 了 之 后 ， 你 就 
只 需要 使 用 面向 对 象 的 思维 去 编写 程序 ， 而 完全 不 用 考虑 数据 库 相 关 的 逻辑 和 实现 了 。 在 大 型 
项 目 当 中 ， 使 用 Room 将 能 够 让 你 的 代码 拥有 更 加 合理 的 分 层 与 设计 , 同时 也 能 让 代码 更 加 易于 
维护 ， 因 此 ，Room 成 为 现在 Android 官 方 最 为 推荐 使 用 的 数据 库 框 架 。 


13.5.2 Room 的 数据 库 升 级 


当然 了 ， 我 们 的 数据 库 结 构 不 可 能 在 设计 好 了 之 后 就 永远 一 成 不 变 ， 随 着 需求 和 版 本 的 变更 ， 
数据 库 也 是 需要 升级 的 。 不 过 遗憾 的 是 ，Room 在 数据 库 升 级 方面 设计 得 非常 烦琐 ， 基 本 上 没有 
比 使 用 原生 的 SQLiteDatabase 简 单 到 哪儿 去 ， 每 一 次 升级 都 需要 于 动 编写 升级 逻辑 才 行 。 相 
比 之 下 ， 我 个 人 编写 的 数据 库 框 架 LitePal 则 可 以 根据 实体 类 的 变化 自动 升级 数据 库 ， 感 兴趣 的 
话 ， 你 可 以 通过 搜索 去 了 解 一 下 。 


不 过 ， 如果 你 目前 还 只 是 在 开发 测试 阶段 ， 不 想 编写 那么 烦琐 的 数据 库 升 级 逻辑 ，Room 倒 也 提 
供 了 一 个 简单 粗暴 的 方法 ， 如 下 所 示 : 


Room.databaseBuilder(context.applicationContext, AppDatabase: :class.java,"app _ database '" ) 
.fallbackToDestructiveMigration() 
.build() 


在 构建 AppDatabase 实 例 的 时 候 ,加 入 一 个 fallbackToDestructiveMigration() 方 
法 。 这 样 只 要 数据 库 进 行 了 升级 ，Room 就 会 将 当前 的 数据 库 销 毁 ， 然 后 再 重新 创建 ， 随 之 而 来 
的 副作用 就 是 之 前 数据 库 中 的 所 有 数据 就 全 部 丢失 了 。 


假如 产品 还 在 开发 和 测试 阶段 ， 这 个 方法 是 可 以 使 用 的 ， 但 是 一 旦 产品 对 外 发 布 之 后 ， 如 果 造 


成 了 用 户 数据 丢失 ， 那 可 是 严重 的 事故 。 因 此 接 下 来 我 们 还 是 老 老 实 实 学 习 一 下 在 Room 中 升级 
数据 库 的 正规 写法 。 
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随 着 业务 逻辑 的 升级 ， 现 在 我 们 打算 在 数据 库 中 添加 一 张 Book 表 ,那么 首先 要 做 的 就 是 创建 一 
个 Book 的 实体 类 ， 如 下 所 示 : 


GEntity 
data class Book(var name: String, var pages: Int) { 


@PrimaryKey(autoGenerate = true) 
var id: Long = 0 


} 


可 以 看 到 ，Book 类 中 包含 了 主键 id、 书 名 、 页 数 这 几 个 字段 ， 并且 我 们 还 使 用 @Entity 注 解 将 
它 声 明成 了 一 个 实体 类 。 


然后 创建 一 个 BookDao 接 口 ， 并 在 其 中 随意 定义 一 些 APl : 


GDao 
interface BookDao { 


@Insert 
fun insertBook(book: Book): Long 


@Query("select * from Book") 
fun loadAllBooks(): List<Book> 


} 


接 下 来 修改 AppDatabase 中 的 代码 ， 在 里 面 编写 数据 库 升 级 的 逻辑 ,如 下 所 示 : 


GDatabase(version = 2, entities = [User::class, Book::class]) 
abstract class AppDatabase : RoomDatabase() { 


abstract fun userDao(): UserDao 
abstract fun bookDao(): BookDao 


companion object { 


val MIGRATION 1 2 = object : Migration(1, 2) { 
override fun migrate(database: SupportSQLiteDatabase) { 
database.execSQL("create table Book (id integer primary 


key autoincrement not null, name text not null, 
pages integer not null)") 


} 


private var instance: AppDatabase? = null 


fun getDatabase(context: Context) 
instance?.let { 
return it 
} 


return Room.databaseBuilder(context.applicationContext, 
AppDatabase: :class.java, "app database") 
.addMigrations (MIGRATION 1 2) 
.build().apply { 
instance = this 


: AppDatabase { 
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} 


观察 一 下 这 里 的 几 处 变化 。 首 先 在 GDatabase 注 和 解 中 ， 我们 将 版 本 号 升级 成 了 2， 并 将 Book 类 
添加 到 了 实体 类 声明 中 ， 然 后 又 提供 了 一 个 bookDao() 方 法 用 于 获取 BookDao 的 实例 。 


接 下 来 就 是 关键 的 地 方 了 ， 在 companion object 结 构 体 中 ， 我们 实现 了 一 个 Mig ration 的 
匿名 类 ， 并 传 入 了 1 和 2 这 两 个 参数 ， 表 示 当 数据 库 版 本 从 1 升级 到 2 的 时 候 就 执行 这 个 匿名 类 中 
的 升级 逻辑 。 匿 名 类 实例 的 变量 命名 也 比较 有 讲究 ， 这 里 命名 成 MIGRATION 1 2 , 可 读 性 更 
高 。 由 于 我 们 要 新 增 一 张 Book 表 ， 所 以 需要 在 migrate( ) 方 法 中 编写 相应 的 建 表 语句 。 另 外 必 
须 注 意 的 是 ，Book 表 的 建 表 语 名 必须 和 Book 实 体 类 中 声明 的 结构 完全 一 致 ， 否则 Room 就 会 抛 
出 异常 。 


最 后 在 构建 AppDatabase 实 例 的 时 候 ， 加 入 一 个 addMigrations () 方 法 ,并 把 
MIGRATION 1 2 传 入 即 可 。 


现在 当 我 们 进行 任何 数据 库 操 作 时 ,Room 就 会 自动 根据 当前 数据 库 的 版 本 号 执行 这 些 升级 逻 
辑 ， 从 而 让 数据 库 始 终 保证 是 最 新 的 版 本 。 


不 过 ,每 次 数据 库 升 级 并 不 一 定 都 要 新 增 一 张 表 ， 也 有 可 能 是 向 现 有 的 表 中 添加 新 的 列 。 这 种 
情况 只 需要 使 用 aLter 语 名 修改 表 结构 就 可 以 了 ， 我 们 来 看 一 下 具体 的 操作 过 程 。 


现在 Book 的 实体 类 中 只 有 id、 书 名 、 页 数 这 几 个 字段 , 而 我 们 想 要 再 添加 一 个 作者 字段 ， 代码 
如 下 所 示 : 


GEntity 
data class Book(var name: String, var pages: Int, var author: String) { 


@PrimaryKey(autoGenerate = true) 
var id: Long = 0 


} 


既然 实体 类 的 字段 发 生 了 变动 ， 那 么 对 应 的 数据 库 表 也 必须 升级 了 ， 所 以 这 里 修改 
AppDatabase 中 的 代码 ,如 下 所 示 : 


GDatabase(version = 3, entities = [User::class, Book::class]) 
abstract class AppDatabase : RoomDatabase() { 


companion object { 


val MIGRATION 2 3 = object : Migration(2, 3) { 
override fun migrate(database: SupportSQLiteDatabase) { 
database.execSQL("alter table Book add column author text not null 
default 'unknown'") 
} 
} 


private var instance: AppDatabase? = null 
fun getDatabase(context: Context): AppDatabase { 


return Room.databaseBuilder(context.applicationContext, 
AppDatabase: :class.java, "app database") 
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.addMigrations (MIGRATION 1 2, MIGRATION 2 3) 
.build().apply { 
instance = this 


} 


升级 步骤 和 之 前 是 差不多 的 ， 这 里 先 将 版 本 号 升级 成 了 3， 然 后 编写 一 个 MIGRATION_2_3 的 升 
级 逻辑 并 添加 到 addMigrations ( ) 方 法 中 即 可 。 比 较 有 难度 的 地 方 就 是 每 次 在 nigrate() 方 
法 中 编写 的 SQL 语句 ， 不 过 即使 与 错 了 也 没关系 ， 因 为 程序 运行 之 后 在 你 首次 操作 数据 库 的 时 
候 就 会 直接 触发 央 溃 ， 并 且 告 诉 你 具体 的 错误 原因 ， 对 照 着 错误 原因 来 改正 你 的 SQL 语句 即 
可 。 


好 了 “， 关 于 Room 你 已 经 了 解 足够 多 的 内 容 了 ， 接 下 来 就 让 我 们 开始 学 习 本 章 的 最 后 一 个 
Jetpack 组 件 一 一 WorkManager。 
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13.6 WorkManager 


Android 的 后 台 机 制 是 一 个 很 复杂 的 话题 ， 连 我 自己 也 没 能 完全 搞 明白 不 同 Android 系 统 版 本 之 
间 后 台 的 功能 与 API 又 发 生 了 哪些 变化 。 在 很 早 之 前 ，Android 系 统 的 后 台 功 能 是 非常 开放 的 ， 
Service 的 优先 级 也 很 高 ， 仪 次 于 Activity， 那 个 时 候 可 以 在 Service 中 做 很 多 事情 。 但 由 于 后 
台 功能 太 过 于 开放 ， 每 个 应 用 都 想 无 限 地 占用 后 台 资 源 ， 导 致 手机 的 内 存 越 来 越 紧 张 ， 耗 电 越 
来 越 快 ， 也 变 得 越 来 越 卡 。 为 了 解决 这 些 情况 ， 基 本 上 Android 系 统 每 发 布 一 个 新 版 本 ， 后 台 权 
限 都 会 被 进一步 收 紧 。 


我 印象 中 与 后 台 相 关 的 API 变 更 大 概 有 这 些 : 从 4.4 系 统 开始 AlarmManager 的 触发 时 间 由 原来 
的 精准 变 为 不 精准 ，5.0 系 统 中 加 入 了 jobScheduler 来 处 理 后 台 任 务 ，6.0 系 统 中 引入 了 Doze 
和 App Standby 模 式 用 于 降低 手机 被 后 台 唤 醒 的 频率 ， 从 8.0 系 统 开始 直接 禁用 了 Service 的 后 
台 功 能 ， 只 人 允许 使 用 前 台 Service。 当 然 ， 还 有 许 许多 多 小 细节 的 修改 ， 我 没 能 全 部 列举 出 来 。 


这 么 频繁 的 功能 和 API 变 更 ， 让 开发 者 就 很 难受 了 ， 到 底 该 如 何 编写 后 台 代码 才能 保证 应 用 程序 
在 不 同系 统 版 本 上 的 兼容 性 呢 ? 为 了 解决 这 个 问题 ，Google 推 出 了 WorkManager 组 件 。 
WorkManager 很 适合 用 于 处 理 一 些 要 求 定时 执行 的 任务 ， 它 可 以 根据 操作 系统 的 版 本 自动 选择 
底层 是 使 用 AlarmManager 实 现 还 是 jobScheduler 实 现 ， 从 而 降低 了 我 们 的 使 用 成 本 。 另 外 ， 
它 还 支持 周期 性 任务 、 链 式 任务 处 理 等 功能 ， 是 一 个 非常 强大 的 工具 。 


不 过 ,我们 还 得 先 明 确 一 件 事 情 : WorkManager 和 Service 并 不 相同 ， 也 没有 直接 的 联系 。 
Service 是 Android 系 统 的 四 大 组 件 之 一 ， 它 在 没有 被 销毁 的 情况 下 是 一 直 保 持 在 后 台 运 行 的 。 
而 WorkManager 只 是 一 个 处 理 定 时 任务 的 工具 ， 它 可 以 保证 即使 在 应 用 退出 其 至 手机 重启 的 情 
况 下 ,之 前 注册 的 任务 仍然 将 会 得 到 执行 ， 因 此 WorkManager 很 适合 用 于 执行 一 些 定期 和 服务 
器 进行 交互 的 任务 ， 比 如 周期 性 地 同步 数据 ， 等 等 。 


另外 ,使 用 WorkManager 注 册 的 周期 性 任务 不 能 保证 一 定 会 准时 执行 ， 这 并 不 是 bug， 而 是 系 
统 为 了 减少 电量 消耗 ， 可 能 会 将 触发 时 间 临 近 的 几 个 任务 放 在 一 起 执行 ， 这 样 可 以 大 幅度 地 减 
少 CPU 被 唤醒 的 次 数 ， 从 而 有 效 延 长 电池 的 使 用 时 间 。 

那么 下 面 我 们 就 开始 学 习 WorkManager 的 具体 用 法 。 

13.6.1 WorkManager 的 基本 用 法 


要 想 使 用 WorkManager , 需要 先 在 app/build.gradle 文 件 中 添加 如 下 的 依赖 : 


dependencies { 


implementation "androidx.work:work-runtime:2.2.0" 


将 依赖 添加 完成 之 后 ， 我 们 就 把 准备 工作 做 好 了 。 
WorkManager 的 基本 用 法 其 实 非常 简单 ， 主 要 分 为 以 人 3 步 : 
(1) 定义 一 个 后 台 任务 ， 并 实现 具体 的 任务 逻辑 ; 
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(2) 配置 该 后 台 任务 的 运行 条 件 和 约束 信息 ， 并 构建 后 台 任务 请 求 ; 

(3) 将 该 后 台 任 务 请 求 传 入 WorkManager 的 enqueue ( ) 方 法 中 ， 系 统 会 在 合适 的 时 间 运 行 。 
那么 接 下 来 我 们 就 按照 上 述 步骤 一 步 步 进 行 实现 。 

第 一 步 要 定义 一 个 后 台 任 务 ,这 里 创建 一 个 SimpLeWo rker 类 ， 代 码 如 下 所 示 : 


class SimpleWorker(context: Context, params: WorkerParameters) : Worker(context, params) { 


override fun doWork(): Result { 
Log.d("SimpleWorker", "do work in SimpleWorker") 
return Result.success() 


} 


} 


后 台 任 务 的 写法 非常 固定 ， 也 很 好 理解 。 首 先 每 一 个 后 台 任 务 都 必须 继承 自 Worker 类 ， 并 调用 
它 唯一 的 构造 函数 。 然 后 重 写 父 类 中 的 dowWork( ) 方 法 ， 在 这 个 方法 中 编写 具体 的 后 台 任 务 逻 辑 
即 可 。 


doWork( ) 方 法 不 会 运行 在 主线 程 当中 ， 因 此 你 可 以 放心 地 在 这 里 执行 耗 时 逻辑 ， 不 过 这 里 简单 
运行 结果 ， 成 功 就 返回 Result ,success () ， 失 败 就 返回 ResuLt .faiLure()。 除 此 之 外 ， 
还 有 一 个 Result. retry ( ) 方 法 ， 它 其 实 也 代表 着 失败 ， 只 是 可 以 结合 

WorkRequest .BuiLder 的 setBackoffCriteria() 方 法 来 重新 执行 任务 ， 我 们 稍 后 会 进行 
学 习 。 


没 错 ， 就 是 这 么 简单 ， 这 样 一 个 后 台 任务 就 定义 好 了 。 接 下 来 可 以 进入 第 二 步 ， 配 置 该 后 台 任 
务 的 运行 条 件 和 约束 信息 。 

这 一 步 其实 也 是 最 复杂 的 一 步 ， 因 为 可 配置 的 内 容 非常 多 ， 不 过 目前 我 们 还 只 是 学 习 
WorkManager 的 基本 用 法 ， 因 此 只 进行 最 基本 的 配置 就 可 以 了 ， 代码 如 下 所 示 : 


val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java).build!() 


可 以 看 到 ， 只 需要 把 刚才 创建 的 后 台 任务 所 对 应 的 CLass 对 象 传 入 
OneTimeWorkRequest .Builder 的 构造 函数 中 ， 然 后 调用 build() 方 法 即 可 完成 构建 。 


OneTimeWorkRequest .Builder 是 WorkRequest.Builder 的 子 类 ，, 用 于 构建 单 次 运行 的 
后 台 任 务 请 求 。WorkRequest .Builder 还 有 另外 一 个 子 类 
PeriodicwWorkRequest.Builder ,可 用 于 构建 周期 性 运行 的 后 台 任 务 请 求 ， 但 是 为 了 降低 
设备 性 能 消耗 ,PeriodicWorkRequest ,Buitder 构 造 亢 数 中 传 入 的 运行 周期 间隔 不 能 短 于 
15 分 钟 ， 示例 代码 如 下 : 


val request = PeriodicWorkRequest.Builder(SimpleWorker::class.java, 15, 
TimeUnit.MINUTES) .build() 
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最 后 一 步 ， 将 构建 出 的 后 台 任 务 请 求 传 入 WorkManager 的 enqueue ( ) 方 法 中 ， 系 统 就 会 在 合 
适 的 时 间 去 运行 了 : 


WorkManager.getInstance(context) .endqueue ( request) 


整体 的 用 法 就 是 这 样 ， 现 在 我 们 来 测试 一 下 吧 。 首 先 在 activity_main.xml 中 新 增 一 个 “Do 
Work” 按 钮 ， 如 下 所 示 : 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical"> 
<Button 
android:id="@+id/doWorkBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:text="Do Work"/> 
</LinearLayout> 


由 于 activity_main.xml 中 的 按钮 已 经 比较 多 了 “， 如 果 新 增 的 按钮 已 经 超出 了 你 的 手机 屏幕 ， 可 
以 使 用 我 们 之 前 学 习 的 ScrollView 控 件 来 滚动 查看 屏幕 外 的 内 容 。 


接 下 来 修改 MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(SavedInstance9tate: Bundle?) { 


doWorkBtn.setOnClickListener { 
val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java).build() 
WorkManager.getInstance(this).enqueue(request) 


} 


代码 非常 简单 ， 就 是 在 “Do Work" 按 钮 的 点 击 事件 中 构建 后 台 任务 请 求 ， 并 将 请 求 传 入 
WorkManager 的 enqueue ( ) 方 法 中 。 后 台 任务 的 具体 运行 时 间 是 由 我 们 所 指定 的 约束 以 及 系 
统 自身 的 一 些 优化 所 决定 的 ， 由 于 这 里 没有 指定 任何 约束 ， 因 此 后 台 任 务 基 本 上 会 在 点 击 按钮 
之 后 立刻 运行 。 

现在 重新 运行 一 下 程序 ， 并 点 击 “Do Work” 按 钮 ,观察 Logcat 中 打印 的 日 志 ,如 图 13.14 所 
个 。 


com.example.jetpacktest (10682) Verbose “部 


791/com.example.jetpacktest D/SimpleWorker: do work in SimpLeworker 
图 13.14 SimpleWorker 中 打印 的 日 志 
可 以 看 到 ，SimpleWorker 确 实 已 经 成 功 运行 了 。 
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好 了 ，WorkManager 的 基本 用 法 就 是 这 么 简单 ， 不 过 接 下 来 我 们 要 去 处 理 一 些 复杂 的 任务 了 。 
13.6.2 使 用 WorkManager 处 理 复 杂 的 任务 


在 上 一 小 节 中 ， 虽 然 我 们 成 功 运行 了 一 个 后 台 任 务 ， 但 是 由 于 不 能 控制 它 的 具体 运行 时 间 ， 
此 并 没有 什么 太 大 的 实际 用 处 。 当然 ， WorkManager 是 不 可 能 没有 提供 这 样 的 接口 的 ,事实 上 
除了 运行 时 间 之 外 , WorkManager 还 允许 我 们 控制 许多 其 他 方面 的 东西 ， 下 面 就 来 具体 看 一 下 
吧 。 


首先 从 最 简单 的 看 起 ， 让 后 台 任 务 在 指定 的 延迟 时 间 后 运行 ， 只 需要 借助 
setInitialDelay() 方 法 就 可 以 了 ， 代码 如 下 所 示 : 


val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) 
.SetInitialDelay(5, TimeUnit.MINUTES) 
.build() 


这 就 表示 我 们 希望 让 SimpleWorker 这 个 后 台 任务 在 5 分 钟 后 运行 。 你 可 以 自由 选择 时 间 的 单 
位 , 毫秒 、 秒 、 分 钟 、 小 时 、 天 都 可 以 。 


可 以 控制 运行 时 间 之 后 ， 我们 再 增加 一 些 别 的 功能 ， 比 如 说 给 后 台 任 务 请 求 添加 标签 : 


val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) 


.addTag ("simple") 
.build() 


那么 添加 了 标签 有 什么 好 处 呢 ? 最 主要 的 一 个 功能 就 是 我 们 可 以 通过 标签 来 取消 后 台 任 务 请 
求 : 


WorkManager.getInstance(this).cancelAllWorkByTag("simple") 


当然 ， 即 使 没有 标签 ,也 可 以 通过 id 来 取消 后 台 任 务 请 求 : 


WorkManager.getInstance(this).canceLworkById (reduest .id) 


但 是 ， 使 用 id 只 能 取消 单个 后 台 任务 请 求 ， 而 使 用 标签 的 话 ， 则 可 以 将 同一 标签 名 的 所 有 后 台 任 
务 i 青 求全 部 取消 ， 这 个 功能 在 逻辑 复杂 的 场景 下 尤其 有 用 。 


除 此 之 外 ， 我 们 也 可 以 使 用 如 下 代码 来 一 次 性 取消 所 有 后 台 任务 请 求 : 


WorkManager.getInstance(this).canceLALLWork() 


另外 ， 我 们 在 上 一 小 节 中 讲 到 ， 如 果 后 台 任务 的 doWork ( ) 方 法 中 返回 了 Result. retry() ， 
那么 是 可 以 结合 setBackoffCriteria() 方 法 来 重新 执行 任务 的 ， 具体 代码 如 下 所 示 : 


val request = OneTimeWorkRequest.Builder(SimpleWorker::class.java) 


.SetBackoffCriteria(BackoffPolicy.LINEAR, 10, TimeUnit.SECONDS) 
.build() 
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setBackoffCriteria() 方 法 接收 3 个 参数 : 第 二 个 和 第 三 个 参数 用 于 指定 在 多 久之 后 重新 执 
行 任务 ， 时 间 最 短 不 能 少 于 10 秒 钟 ; 第 一 个 参数 则 用 于 指定 如 果 任 务 再 次 执行 失败 ， 下 次 重 试 
的 时 间 应 该 以 什么 样 的 形式 延迟 。 这 其 实 很 好 理解 ， 假 如 任务 一 直 执行 失败 ， 不 断 地 重新 执行 

似乎 并 没有 什么 意义 ， 只 会 徒 增设 备 的 性 能 消耗 。 而 随 着 失败 次 数 的 增多 ， 下 次 重 试 的 时 间 也 

应 该 进行 适当 的 延迟 ， 这 才 是 更 加 合理 的 机 制 。 第 一 个 参数 的 可 选 值 有 两 种 ， 分 别 是 LINEAR 和 
EXPONENTIAL， 前 者 代表 下 次 重 试 时 间 以 线性 的 方式 延迟 ， 后 者 代表 下 次 重 试 时 间 以 指数 的 方 
式 延 迟 。 


了 解 了 Result. retry () 的 作用 之 后 ,你 一 定 还 想 知 道 ,dowWork ( ) 方 法 中 返回 
Result.success() 和 Result.failure() 又 有 什么 作用 ?这 两 个 返回 值 其 实 就 是 用 于 通知 
任务 运行 结果 的 ， 我们 可 以 使 用 如 下 代码 对 后 台 任 务 的 运行 结果 进行 监听 : 


WorkManager.getInstance(this) 
.getworkInfoByIdLiveData(request.1id) 
.Observe(this) { workInfo -> 
if (workInfo.state == WorkInfo.State.SUCCEEDED) { 
Log.d("MainActivity", "do work succeeded") 
} else if (workInfo.state == WorkInfo.State.FAILED) { 
Log.d("MainActivity", "do work failed") 


} 


这 里 调用 了 getworkInfoByIdLiveData() 方 法 ,并 传 入 后 台 任 务 请 求 的 ijd ,会 返回 一 个 
LiveData 对 象 。 然 后 我 们 就 可 以 调用 LiveData 对 象 的 0observe( ) 方 法 来 观察 数据 变化 了 ， 
以 此 监听 后 台 任 务 的 运行 结果 。 


另外 ,你 也 可 以 调用 getwWorkInfosByTagLiveData() 方 法 , 监听 同一 标签 名 下 所 有 后 台 任 
务 请 求 的 运行 结果 ， 用 法 是 差不多 的 ， 这 里 就 不 再 进行 解释 了 。 


接 下 来 ， 我 们 再 来 看 一 下 WorkManager 中 比较 有 特色 的 一 个 功能 一 一 链 式 任务 。 


假设 这 里 定义 了 3 个 独立 的 后 台 任 务 : 同步 数据 、 压 缩 数 据 和 上 传 数据 。 现 在 我 们 想 要 实现 先 同 
步 、 再 压缩 、 最 后 上 传 的 功能 ， 就 可 以 借助 链 式 任务 来 实现 ， 代 码 示例 如 下 : 


val Sync = ,,， 

val compress = ... 

val upload = ... 

WorkManager.getInstance(this) 
.beginwWith(sync) 
.then(compress ) 
.then(upLoad ) 
.enqueue () 


这 段 代 码 还 是 比较 好 理解 的 ， 相 信 你 一 看 就 能 懂 。beginWith ( ) 方 法 用 于 开启 一 个 链 式 任务 ， 
至 于 后 面 要 接 上 什么 样 的 后 台 任务 ， 只 需要 使 用 then( ) 方 法 来 连接 即 可 。 另 外 WorkManager 
还 要 求 ， 必 须 在 前 一 个 后 台 任务 运行 成 功 之 后 ,下 一 个 后 台 任务 才 会 运行 。 也 就 是 说 ， 如果 某 

个 后 台 任务 运行 失败 ， 或 者 被 取消 了 ， 那 么 接 下 来 的 后 台 任务 就 都 得 不 到 运行 了 。 


在 本 节 的 最 后 ,我 还 想 多 说 几 名 。 前 面 所 介绍 的 WorkManager 的 所 有 功能 , 在 国产 手机 上 都 有 
可 能 得 不 到 正确 的 运行 。 这 是 因为 绝 大 多 数 的 国产 手机 厂商 在 进行 Android 系 统 定制 的 时 候 会 增 
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加 一 个 一 键 关 闭 的 功能 ， 人 允许 用 户 一 键 杀 死 所 有 非 白 名 单 的 应 用 程序 。 而 被 杀 死 的 应 用 程序 既 
无 法 接收 广播 ， 也 无 法 运行 WorkManager 的 后 台 任务 。 这 个 功能 虽然 与 Android 原 生 系统 的 设 
计 理 念 并 不 相符 ， 但 是 我 们 也 没有 什么 解决 办 法 。 或 许 就 是 因为 有 太 多 恶意 应 用 总 是 想 要 无 限 
占用 后 台 ， 国产 手机 广 商 才 增加 了 这 个 功能 吧 。 因 此 ,这 里 给 你 的 建议 就 是 ,WorkManager 可 
以 用 ， 但 是 干 万 别 依赖 它 去 实现 什么 核心 功能 ， 因 为 它 在 国产 手机 上 可 能 会 非常 不 稳定 。 


好 了 ， 关 于 WorkManager ,你 所 需要 知道 的 内 容 大 概 就 是 这 些 了 ， 那么 我 们 本 章 对 于 Jetpack 
的 学 习 也 就 到 此 为 止 。 目 前 你 已 经 具备 了 开发 一 款 高 质量 架构 Android 应 用 的 能 力 ， 在 第 15 章 
中 会 给 你 真正 的 实战 机 会 。 但 是 现在 ， 我 们 还 是 按照 惯例 ， 进 入 本 章 的 Kotlin 课 堂 ， 学 习 更 多 的 
知识 和 技能 。 
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13.7 Kotlin 课 堂 : 使 用 DSL 构 建 专 有 的 语法 结构 


日 五 主 


DSL 的 全 称 是 领域 特定 语言 (Domain Specific Language) ， 它 是 编程 语言 赋予 开发 者 的 一 
种 特殊 能 力 ， 通 过 它 我 们 可 以 编写 出 一 些 看 似 脱离 其 原始 语法 结构 的 代码 ， 从 而 构建 出 一 种 专 

有 的 语法 结构 。 

毫 无 疑问 ，Kotlin 也 是 支持 DSL 的 ， 并 且 在 Kotlin 中 实现 DSL 的 实现 方式 并 不 固定 ， 比 如 我 们 之 
前 在 第 9 章 的 Kotlin 课 堂 中 使 用 infix 也 数 构建 出 的 特有 语法 结构 就 属于 DSL。 不 过 本 节 课 我 们 的 
主要 学 习 目 标 是 通过 高 阶 函 数 的 方式 来 实现 DSL , 这 也 是 Kotlin 中 实现 DSL 最 常见 的 方式 。 

不 管 你 有 没有 察觉 到 ， 其 实 长 久 以 来 你 一 直 都 在 使 用 DSL。 比 如 我 们 想 要 在 项 目 中 添加 一 些 依 

赖 库 ， 需要 在 build.gradle 文 件 中 编写 如 下 内 容 : 


dependencies { 
implementation 'com.squareup.retrofit2:retrofit:2.6.1'" 
implementation 'com.squareup.retrofit2:converter-gson:2.6.1' 


} 


Gradle 是 一 种 基于 Groovy 语 言 的 构建 工具 ， 因 此 上 述 的 语法 结构 其 实 就 是 Groovy 提 供 的 DSL 
功能 。 有 没有 觉得 很 神奇 ? 不 用 吃惊 ， 借 助 Kotlin 的 DSL , 我 们 也 可 以 实现 类 似 的 语法 结构 ， 下 
面 就 来 具体 看 一 下 吧 。 


首先 新 建 一 个 DSL.kt 文 件 ， 然后 在 里 面 定义 一 个 Dependency 类 ， 代码 如 下 所 示 : 


class Dependency { 
val libraries = ArrayList<String>() 


fun impLementation(Lib: String) { 
Libraries.add(Lib) 
} 


} 


这 里 我 们 使 用 了 一 个 List 集 合 来 保存 所 有 的 依赖 库 ， 然 后 又 提供 了 一 个 jmplementation() 方 
法 ， 用 于 向 List 集 合 中 添加 依赖 库 ， 代码 非常 简单 。 


接 下 来 再 定义 一 个 dependencies 高 阶 函 数 ， 代码 如 下 所 示 : 


fun dependencies(block: Dependency.() -> Unit): List<String> { 
val dependency = Dependency () 
dependency.block() 
return dependency.Libraries 


} 
可 以 看 到 ,dependencies 函 数 接收 一 个 函数 类 型 参数 ， 并 且 该 参数 是 定义 到 Dependency 类 
中 的 ， 因 此 调用 它 的 时 候 需 要 先 创建 一 个 Dependency 的 实例 ， 然 后 再 通过 该 实例 调用 函数 类 
型 参数 ,这样 传 入 的 Lambda 表 达 式 就 能 得 到 执行 了 。 最 后 ， 我 们 将 Dependency 类 中 保存 的 
依赖 库 集合 返回 。 
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没 错 ， 经 过 这 样 的 DSL 设 计 之 后 ， 我 们 就 可 以 在 项 目 中 使 用 如 下 的 语法 结构 了 : 


dependencies { 
implementation("com.squareup.retrofit2:retrofit:2.6.1") 
implementation("com.squareup.retrofit2:converter-gson:2.6.1") 


} 


这 里 我 来 简单 解释 一 下 。 由 于 dependencies 函 数 接收 一 个 国 数 类 型 参数 ， 因 此 这 里 我 们 可 以 
传 入 一 个 Lambda 表 达 式 。 而 此 时 的 Lambda 表 达 式 中 拥有 Dependency 类 的 上 下 文 ， 因 此 当 
然 就 可 以 直接 调用 Dependency 类 中 的 jmplementation() 方 法 来 添加 依赖 库 了 。 


当然 ， 这 种 语法 结构 和 我 们 在 build.gradle 文 件 中 使 用 的 语法 结构 并 不 完全 相同 ， 这 主要 是 因 
为 Kotlin 和 Groovy 在 语法 层面 还 是 有 一 定 差别 的 。 


男 外 , 我 们 也 可 以 通过 dependencies 也 数 的 返回 值 来 获取 所 有 添加 的 依赖 库 ， 代码 如 下 所 
示 : 


fun main() { 
val libraries = dependencies { 
implementation("com.squareup.retrofit2:retrofit:2.6.1") 
implementation("com.squareup.retrofit2:converter-gson:2.6.1") 


for (lib in libraries) { 
printLn(Lib) 


} 


这 里 用 一 个 Libraries 变 量 接收 dependencies 函 数 的 返回 值 , 然后 使 用 for - in 循环 将 集合 
中 的 依赖 库 全 部 打印 出 来 。 现 在 运行 一 人 main ( ) 函数 ， 结 果 如 图 13.15 所 示 。 


# 


Run: _ app com.example.jetpacktest.DSLKt 

"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
com. squareup. retrofit2:retrofit:2.6.1 

com. squareup,. retrofit2:converter-gson:2.6.1 


Process finished with exit code 0 


图 13.15 获得 所 有 添加 的 依赖 库 
可 以 看 到 ， 我 们 已 经 成 功 将 使 用 DSL 语 法 结构 添加 的 依赖 库 全 部 获取 到 了 。 


这 种 语法 结构 比 起 直接 调用 Dependency 对 象 的 impLementation( ) 方 法 要 更 直观 一 些 , 而 且 
你 会 发 现 ， 需 要 添加 的 依赖 库 越 多 ， 使 用 DSL 与 法 的 优势 就 会 越 明显 。 


在 实现 了 一 个 较为 简单 的 DSL 之 后 ， 接 下 来 我 们 再 尝试 编写 一 个 复杂 一 点 的 DSL。 

如 果 你 了 解 一 些 前 端 开发 的 话 ， 应 该 知道 网 页 的 展示 都 是 由 浏览 器 解析 HTML 代 码 来 实现 的 。 
HTML 中 定义 了 很 多 标签 ， 其 中 <tabLe> 标 签 用 于 创建 一 个 表格 ，<tr> 标 签 用 于 创建 表格 的 
行 ，<td> 标 签 用 于 创建 单元 格 。 将 这 3 种 标签 能 套 使 用 ,就 可 以 定制 出 包含 任意 行列 的 表格 
Ts 


这 里 我 们 来 做 个 实验 吧 ,首先 创建 一 个 test.txt 文 件 ， 并 在 其 中 编写 如 下 HTML 代 码 : 
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<table> 
<tr> 
<td>Apple</td> 
<td>Grape</td> 
<td>0range</td> 
</tr> 
<tr> 
<td>Pear</td> 
<td>Banana</td> 
<td>wWatermelon</td> 
</tr> 
</table> 


这 段 代 码 会 创建 出 一 个 两 行 三 列 的 表格 。 那 么 要 如 何 进行 验证 呢 ? 很 简单 ， 修 改 一 下 文件 的 后 
缀 名 就 可 以 了 ， 这 里 将 文件 改名 成 test.html， 然后 双击 文件 ,使 用 浏览 莫 打 开 即 可 ， 效果 如 图 
13.16 所 示 。 

© ©®@ testhtml x 下 


CO@ 文件 | /Users/guolin/Documents/test.html 


Apple Grape Orange 
Pear Banana Watermelon 


图 13.16 ”两 行 三 列 的 表格 效果 

这 就 是 一 个 两 行 三 列表 格 的 效果 , 只 是 默认 情况 下 表格 边框 的 宽度 是 零 ， 所 以 我 们 看 不 到 边框 
而 已 。 

那么 如 果 现 在 有 一 个 需求 ， 要 求 我 们 在 Kotlin 中 动态 生成 表格 所 对 应 的 HTML 人 代码， 你 会 怎么 做 
呢 ? 最 简单 直接 的 方式 就 是 字符 串 拼 接 了 ， 但 是 这 种 做 法 显然 十 分 烦琐 ， 而 且 字符 串 拼接 的 代 
码 也 难以 阅读 。 

这 个 时 候 DSL 又 可 以 大 显 身 手 了 ， 借助 DSL ,我们 可 以 以 一 种 不 可 思议 的 语法 结构 来 动态 生成 表 
格 所 对 应 的 HTML 人 代码， 下 面 就 来 看 一 下 具体 应 该 如 何 实现 吧 。 


仍然 是 在 DSL.kt 文 件 中 进行 编写 ， 首 先 定义 一 个 Td 类 ， 代 码 如 下 所 示 : 


class Td { 
Var content = "" 


fun html() = "\n\t\t<td>$content</td>" 
} 


由 于 <td> 标 签 表 示 一 个 单元 格 ， 其 中 必然 是 要 包含 内 容 的 ， 因 此 这 里 我 们 使 用 了 一 个 content 
字段 来 存储 单元 格 中 显示 的 内 容 。 另 外 ， 还 提供 了 一 个 html () 方 法 ， 当 调用 这 个 方法 时 就 返回 
一 段 <td> 标 签 的 HTML 代 码 ， 并 将 content 中 存储 的 内 容 拼接 进去 。 注 意 ， 为 了 让 最 终 输 出 的 
结果 更 加 直观 ， 我 使 用 了 \n 和 \t 转 义 符 来 进行 换行 和 缩 进 ， 当然 你 可 以 不 加 这 些 转 义 符 ， 因 为 
浏览 右 在 解析 HTML 代 码 时 是 忽略 换行 和 缩 进 的 。 


完成 了 Td 类 ， 接 下 来 我 们 再 定义 一 个 Tr 类 ， 代码 如 下 所 示 : 
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class Tr { 
private val children = ArrayList<Td>() 


fun td(block: Td.() -> String) { 
val td = Td() 
td.content = td.block() 
children.add(td) 


fun html(): String { 
val builder = StringBuilder() 
builder.append("\n\t<tr>") 
for (childTag in children) { 
builder.append(childTag.html()) 


} 
builder.append("\n\t</tr>") 
return builder.toString() 


} 


} 


Tr 类 相 比 于 Td 类 就 要 复杂 一 些 了 。 由 于 <tr> 标 签 表示 表格 的 行 ， 它 是 可 以 包含 多 个 <td> 标 签 

的 ,因此 我 们 首先 创建 了 一 个 chitldren 和 集合 ， 用 于 存储 当前 Tr 所 包含 的 Td 对 象 。 接 下 来 提供 

了 一 个 td ( ) 函 数 ， 它 接收 一 个 定义 到 Td 类 中 并 且 返 回 值 是 String 的 函数 类 型 参数 。 当 调用 

td ( ) 消 数 时 ，, 会 先 创建 一 个 Td 对 象 ， 接 着 调用 水 数 类 型 参数 并 获取 它 的 返回 值 ， 然 后 赋值 Td 
类 的 content 字 段 当 中 ， 这 样 就 可 以 将 调用 td( ) 函数 时 传 入 的 Lambda 表 达 式 的 返回 值 赋值 给 
content 字 段 了 。 当 然 ， 这 里 既然 创建 了 一 个 Td 对 象 ， 就 一 定 要 记得 将 它 添加 到 Jchildren 集 

合 当中 。 


另外 ,Tr 类 中 也 定义 了 一 个 htmt ( ) 方 法 ， 它 的 作用 和 刚才 Td 类 中 的 htmt( ) 方 法 一 致 。 只 是 由 
于 每 个 Tr 都 可 能 会 包含 很 多 个 Td， 因 此 我 们 需要 使 用 循环 来 遍历 chiLdren 集 合 ， 将 所 有 的 子 
Td 都 拼接 到 <tr> 标 签 当 中 ， 从 而 返回 一 段 肉 套 的 HTML 代 码 。 


定义 好 了 Tr 类 之 后 ,我们 现在 就 可 以 使 用 如 下 的 语法 格式 来 构建 表格 中 的 一 行 数据 : 


val tr = Tr() 

tr.td { "Apple" } 
tr.td { "Grape" } 
tr.td { "Orange" } 


好 像 已 经 有 那么 回 事 了 ， 但 这 仍然 不 是 我 们 追求 的 最 终 效果 。 那 么 接 下 来 继续 对 DSL 进 行 完 
善 ， 再 定义 一 个 Table 类 ,代码 如 下 所 示 : 


class Table { 
private val children = ArrayList<Tr>() 


fun tr(block: Tr.() -> Unit) { 
val tr = Tr() 
tr.block() 
children.add(tr) 


fun html(): String { 
val builder = StringBuilder() 
builder.append("<table>") 
for (childTag in children) { 
builder.append(childTag.html()) 
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} 
builder.append("\n</table>") 
return builder.toString() 


这 段 代 码 相对 就 好 理解 多 了 ， 因 为 和 刚才 Tr 类 中 的 代码 是 比较 相似 的 。Table 类 中 同样 创建 了 

一 个 chiLdren 集 合 ,用 于 存储 当前 TabLe 所 包含 的 Tr 对 象 。 然 后 定义 了 一 个 tr() 函 数 , 它 接 
收 一 个 定义 到 Tr 类 中 的 函数 类 型 参数 。 当 调用 tr ( ) 函数 时 ， 会 先 创建 一 个 Tr 对 象 ， 接着 调用 函 
数 类 型 参数 ,这样 Lambda 表 达 式 中 的 代码 就 能 得 到 执行 。 最 后 ， 仍 然 要 记得 将 创建 的 Tr 对 象 

添加 到 chitLd ren 集 合 当中 。 


除 此 之 外 , htmt () 方 法 中 的 代码 也 都 是 类 似 的 ， 这 里 遍历 了 chitLd ren 集 合 ， 将 所 有 的 子 Tr 对 
象 都 拼接 到 了 <tabLe> 标 签 当中 。 


那么 现在 ， 我 们 就 可 以 使 用 如 下 的 语法 结构 来 构建 一 个 表格 了 : 


val table = Table() 
table.tr { 
td { "Apple" } 
td { "Grape" } 
td { "Orange" } 


3 
table.tr { 
td { "Pear" } 
td { "Banana" } 
td { "Watermelon" } 


} 


这 段 代码 看 上 去 已 经 相当 不 错 了 ， 不 过 这 仍然 不 是 最 终 版 本 ， 我们 还 可 以 再 进一步 对 语法 结构 
进行 精简 。 定 义 一 个 table( ) 函 数 ， 代 码 如 下 所 示 : 


fun table(block: Table.() -> Unit): String { 
val table = Table() 
table.block() 
return table.html() 


} 


这 里 的 table ( ) 消 数 接收 一 个 定义 到 Table 类 中 的 水 数 类 型 参数 ， 当 调用 table ( ) 明 数 时 ， 会 
先 创建 一 个 TabLe 对 象 ， 接 着 调用 函数 类 型 参数 ,这样 Lambda 表 达 式 中 的 代码 就 能 得 到 执 
行 。 最 后 调用 Table 的 html ( ) 方 法 获取 生成 的 HTML 代 码 ， 并 作为 最 终 的 返回 值 返回 。 


编写 了 这 么 多 代码 之 后 ， 我 们 就 可 以 使 用 如 下 神奇 的 语法 结构 来 动态 生成 一 个 表格 所 对 应 的 
HTML 代 码 了 : 


fun main() { 
val html = table { 

tr { 
td { "Apple" } 
td { "Grape" } 
td { "Orange" } 

} 

tr { 
td { "Pear" } 
td { "Banana" } 


www.blogss.cn 


td { "Watermelon" } 


} 


} 
println(html) 
} 


怎么 样 ? 这 种 DSL 结 构 的 语法 是 不 是 语义 性 很 强 ， 一 看 就 懂 ? 而 且 很 难 想象 这 种 语法 结构 竟然 
是 用 Kotlin 语 言 编写 出 来 的 吧 ? 现在 我 们 可 以 运行 一 人 main( ) 消 数 ， 结 果 如 图 13.17 所 示 。 


Run: _ app ~ com.example.jetpacktest.DSLKt 


"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java” ... 
<table> 
<tr> 
<td>Apple</td> 
<td>Grape</td> 
<td>0range</td> 


> 


</tr> 

<tr> 
<td>Pear</td> 
<td>Banana</td> 

ps <td>WatermeLon</td> 
</tr> 

</table> 


@ le YI 


Process finished with exit code 0 
图 13.17 使 用 DSL 生 成 的 表格 HTML 代 码 
可 以 看 到 ， 这 样 我 们 就 能 够 轻松 地 生成 任意 表格 所 对 应 的 HTML 代 码 了 。 


另外 ， 在 DSL 中 也 可 以 使 用 Kotlin 的 其 他 语法 特性 ， 比 如 通过 循环 来 批量 生成 <tr> 和 <td> 标 
签 : 


fun main() { 
val html = table { 
repeat(2) { 
tr { 
val fruits = list0f("Apple", "Grape", "Orange") 
for (fruit in fruits) { 
td { fruit } 
} 


} 


} 
println(html) 


这 里 使 用 了 repeat ( ) 国 数 来 为 表格 生成 两 行 数据 ,每 行 数据 中 又 使 用 了 for -in 循环 来 遍历 
List 集 合 ， 为 表格 填充 具体 的 单元 格 数据 。 最 终 的 运行 结果 如 图 13.18 所 示 。 
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Run: _app | com.example.jetpacktest.DSLKt 
"/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home/bin/java" ... 
> <table> 
<tr> 
<td>Apple</td> 
<td>Grape</td> 
<td>0range</td> 
</tr> 
<tr> 
<td>Apple</td> 
<td>Grape</td> 
ps <td>0range</td> 
</tr> 
</table> 


ll le YI 


Process finished with exit code 0 


图 13.18 使 用 循环 批量 生成 表格 内 容 


在 这 个 例子 中 ， 我 们 充分 利用 了 Kotlin 高 阶 函 数 的 特性 ， 完 成 了 一 个 难度 颇 高 的 DSL 定 制 ， 希 望 
你 能 从 中 受益 良 多 。 当 你 在 以 后 的 开发 工作 中 也 需要 进行 DSL 定 制 的 时 候 ， 相 信 本 节 Kotlin 课 党 
的 内 容 一 定 能 够 给 你 提供 很 好 的 思路 与 帮助 。 


好 了 ， 关 于 Kotlin DSL 的 内 容 我 们 就 学 到 这 里 ， 接 下 来 我 们 就 总 结 一 下 本 章 所 学 习 的 知识 吧 。 
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13.8 小 结 与 皮 评 


在 本 章 中 ， 我 们 对 Google 新 推出 的 开发 组 件 工具 集 jJetpack 进 行 了 学 习 。 当 然 , jetpack 包 含 的 
面 很 广 , 所 以 我 们 只 是 重点 学 习 了 其 中 的 架构 组 件 。 架 构 组 件 主要 是 为 了 帮助 开发 者 编写 出 更 
加 符合 高 质量 代码 规范 、 更 加 具有 架构 设计 的 应 用 程序 , 尤其 是 ViewModel、Lifecycles 和 
LiveData 这 3 个 组 件 ， 简 直 就 是 为 MVVM 架 构 而 量 身 打造 的 ， 我 们 将 会 在 第 15 章 中 使 用 MVVM 
架构 编写 一 个 完整 的 实战 项 目 。 


而 本 章 中 学 习 的 Room 作为 数据 库 功 能 的 补充 ,在 很 大 程度 上 也 能 提升 应 用 程序 在 本 地 存储 方面 
的 架构 设计 。WorkManager 则 给 我 们 提供 了 执行 后 台 任务 的 另外 一 种 选择 ， 但 请 注意 , 它 和 
Service 是 完全 不 同 的 。 


在 本 章 的 Kotlin 课 堂 中 ,我们 学 习 了 一 项 颇 有 难度 的 新 技术 一 一 构建 DSL，, 但 其 实 本 章 并 没有 用 
到 任何 Kotlin 的 新 知识 点 ，} 0 一 段 看 似 不 属于 Kotlin 语 
言 的 语法 结构 。 构 建 DSL 可 能 并 不 属于 非常 常用 的 功能 你 真正 需要 构建 DSL 的 时 候 ， 来 
翻 一 下 本 节 课 的 内 容 ， 相信 一 定 会 给 你 带 来 不 少 帮 了 助 。 


现在 你 已 经 足 足 学 习 了 13 章 的 内 容 ， 对 Android 应 用 程序 开发 的 理解 应 该 比较 深刻 了 。 目 前 系 
统 性 的 知识 点 几乎 已 经 全 部 讲 完了 , 但 是 还 有 一 些 零散 的 高 级 技巧 在 等 待 着 你 ， 那 么 就 让 我 们 
赶快 进入 下 一 章 的 学 习 当 中 吧 。 
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第 14 章 继续 进 阶 ,你 还 应 该 掌握 的 高 级 技 
巧 


本 书 的 内 容 虽 然 已 经 接近 尾声 了 ， 但 是 干 万 不 要 因此 而 放松 ， 现 在 正 是 你 继续 进 阶 的 时 机 。 相 
信和 基础 性 的 Android 知 识 已 经 没有 太 多 能 够 难 倒 你 的 了 ， 那 么 本 章 中 我 们 就 来 学 习 一 些 你 还 应 该 
掌握 的 高 级 技巧 吧 。 
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14.1 全 局 获取 Context 的 技巧 


回想 这 么 久 以 来 我 们 所 学 的 内 容 ， 你 会 发 现 有 很 多 地 方 都 需要 用 到 Context，, 弹出 Toast 的 时 候 
需要 ， 启动 Activity 的 时 候 需要 ， 发 送 广播 的 时 候 需 要 ， 操作 数据 库 的 时 候 需要 ， 使 用 通知 的 时 


或 许 目前 你 还 没有 为 得 不 到 Context 而 发 愁 过 ， 因 为 我 们 很 多 的 操作 是 在 Activity 中 进行 的 ， 
而 Activity 本 身 就 是 一 个 Context 对 象 。 但 是 ， 当 应 用 程序 的 架构 逐渐 开始 复杂 起 来 的 时 候 ， 
很 多 逻辑 代码 将 脱离 Activity 类 ,但 此 时 你 又 恰恰 需要 使 用 Context ,也 许 这 个 时 候 你 就 会 
感到 有 些 伤 脑筋 了 。 


例如 ,在 第 12 章 的 Kotlin 课 堂 中 ,我 们 编写 了 一 个 Toast.kt 文 件 , 并 在 这 里 对 Toast 的 用 法 进行 
了 封装 ， 代 码 如 下 所 示 : 


fun String.showToast(context: Context, duration: Int = Toast.LENGTH SHORT) { 
Toast.makeText (context, this, duration).show() 


fun Int.showToast(context: Context, duration: Int = Toast.LENGTH SHORT) { 
Toast.makeText(context, this, duration).show() 


} 


可 以 看 到 ， 由 于 Toast 的 makeText ( ) 方 法 要 求 传 入 一 个 Context 参 数 ， 但 是 当前 代码 既 不 在 
Activity 当 中 ， 也 不 在 Service 当 中 ， 是 没有 办 法 直接 获取 Context 对 象 的 。 于 是 这 里 我 们 只 好 
给 showToast() 方 法 添加 了 一 个 Context 参 数 ， 让 调用 showToast() 方 法 的 人 传递 一 个 
Context 对 象 进来 。 


虽说 这 也 是 一 种 解决 方案 , 但 是 有 点 推卸 责任 的 嫌疑 ， 因 为 我 们 将 获取 Context 的 任务 转移 给 
了 showToast ( ) 方 法 的 调用 方 ， 至 于 调用 方 能 不 能 得 到 Context 对 象 ， 那 就 不 是 我 们 需要 考虑 
的 问题 了 。 


由 此 可 以 看 出 ， 在 某 些 情况 下 ， 获取 Context 并 非 是 那么 容易 的 一 件 事 ， 有 了 时候 还 是 挺 伤 脑筋 
的 。 不 过 别 担心 ,下 面 我 们 就 来 学 习 一 种 技巧 ， 让 你 在 项 目的 任何 地 方 都 能 够 轻松 获取 
Context, 


Android 提 供 了 一 个 Application 类 , 每 当 应 用 程序 启动 的 时 候 ， 系统 就 会 自动 将 这 个 类 进行 
初始 化 。 而 我 们 可 以 定制 一 个 自己 的 AppLication 类 ， 以 便于 管理 程序 内 一 些 全 局 的 状态 信 
息 ,比如 全 局 Context。 


定制 一 个 自己 的 AppLication 其 实 并 不 复杂 ， 首 先 需要 创建 一 个 MyAppLication 类 继承 自 
AppLication， 代码 如 下 所 示 : 


class MyApplication : AppLication() { 


companion object { 
lateinit var context: Context 
} 


override fun onCreate() { 
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Super.onCreate() 
context = appLicationContext 


可 以 看 到 , MyApplication 中 的 代码 非常 简单 。 这 里 我 们 在 companion object 中 定义 了 一 
个 context 变 量 ， 然 后 重 写 父 类 的 onCreate ( ) 方 法 ， 并 将 调用 
getAppLicationContext( ) 方 法 得 到 的 返回 值 赋值 给 context 变 量 ， 这 样 我 们 就 可 以 以 静 
态 变量 的 形式 获取 Context 对 象 了 。 


需要 注意 的 是 ,将 Context 设 置 成 静态 变量 很 容易 会 产生 内 存 泄 漏 的 问题 ， 所 以 这 是 一 种 有 风 
险 的 做 法 ， 因 此 Android Studio 会 给 出 如 图 14.1 所 示 的 警告 提示 。 


class MyApplication : AppLication() { 


companion object { 
lateinit var context: Context 


Do not place Android context classes in static fields; this is a memory leak more... ( 哲 F1) 
super.onCreate() 
context = applicationContext 
} 


上 T 


} 
图 14.1 提示 有 内 存 泄漏 的 风险 


但 是 由 于 这 里 获取 的 不 是 Activity 或 Service 中 的 Context， 而 是 Application 中 的 Context ， 
它 全 局 只 会 存在 一 份 实例 ， 并 且 在 整个 应 用 程序 的 生命 周期 内 都 不 会 回收 ， 因 此 是 不 存在 内 存 
泄漏 风险 的 。 那 么 我 们 可 以 使 用 如 下 注解 ， 让 Android Studio 包 略 上 述 和 警告 提示 : 


class MyApplication : AppLication() { 


companion object { 
@SuppressLint("StaticFieldLeak") 
lateinit var context: Context 


} 


接 下 来 我 们 还 需要 告知 系统 ， 当 程序 启动 的 时 候 应 该 初始 化 MyApplication 类 , 而 不 是 默认 的 
AppLication 类 。 这 一 步 也 很 简单 ， 在 AndroidManifest.xml 文 件 的 <appLication> 标 签 下 
进行 指定 就 可 以 了 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.materialtest"> 
<application 
android:name=" .MyApplication" 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher_ round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 
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</appLication> 
</manifest> 


这 样 我 们 就 实现 了 一 种 全 局 获取 Context 的 机 制 , 之 后 不 管 你 想 在 项 目的 任何 地 方 使 用 
Context , 只 需要 调用 一 下 MyApplication.context 就 可 以 了 。 


那么 接 下 来 我 们 再 对 showToast () 方 法 进行 优化 ,代码 如 下 所 示 : 


fun String.showToast(duration: Int = Toast.LENGTH SHORT) { 
Toast.makeText (MyApplication.context, this, duration).show() 
} 


fun Int.showToast(duration: Int = Toast.LENGTH SHORT) { 
Toast.makeText (MyApplication.context, this, duration).show() 
} 


可 以 看 到 ,showToast ( ) 方 法 不 需要 再 通过 传递 参数 的 方式 得 到 Context 对 象 ， 0 下 
MyApplication.context 就 可 以 了 。 这 样 showToast ( ) 方 法 的 用 法 也 得 到 了 进一步 的 精 
简 ，, 现在 只 需要 使 用 如 下 写法 就 能 弹出 一 段 文 字 提 示 : 


"This is Toast".showToast() 


有 了 这 个 技巧 ， 你 就 再 也 不 用 为 得 不 到 Context 对 象 而 发 悉 
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14.2 使 用 Intent 传 递 对 象 


Intent 的 用 法 相信 你 已 经 比较 熟悉 了 ， 我 们 可 以 借助 它 来 启动 Activity、 启 动 Service、 发 送 广 
播 等 。 在 进行 上 述 操作 的 时 候 ， 我 们 还 可 以 在 Intent 中 添加 一 些 附 加 数据 ， 以 达到 传 值 的 效 
果 ,比如 在 FirstActivity 中 添加 如 下 代码 : 


val intent = Intent(this, SecondActivity::class.java) 
intent.putExtra("string data", "hello") 
intent.putExtra("int data", 100) 
startActivity(intent) 


这 里 调用 了 Intent 的 putExtra( ) 方 法 来 添加 要 传递 的 数据 ,之 后 在 SecondActivity 中 就 可 
以 得 到 这 些 值 了 ， 代 码 如 下 所 示 : 


intent.getStringExtra("string data") 
intent.getIntExtra("int data", 0) 


但 是 不 知道 你 有 没有 发 现 ，putExtra( ) 方 法 中 所 支持 的 数据 类 型 是 有 限 的 ， 虽然 常用 的 一 些 
数据 类 型 是 支持 的 ， 但 是 当 你 想 去 传递 一 些 自 定 义 对 象 的 时 候 ， 就 会 发 现 无 从 下 于 。 不 用 担 
心 ， 下 面 我 们 就 学 习 一 下 使 用 Intent 来 传递 对 象 的 技巧 。 


14.2.1 Serializable 方 式 


使 用 Intent 来 传递 对 象 通常 有 两 种 实现 方式 : Serializable 和 Parcelable。 本 小 节 中 我 们 先 来 学 
习 一 下 第 一 种 实现 方式 。 


Serializable 是 序列 化 的 意思 ， 表 示 将 一 个 对 象 转换 成 可 存储 或 可 传输 的 状态 。 序 列 化 后 的 对 象 
可 以 在 网 络 上 进行 传输 ,也 可 以 存储 到 本 地 。 至 于 序列 化 的 方法 非常 简单 ， 只 需要 让 一 个 类 去 
实现 Serializable 这 个 接口 就 可 以 了 。 


比如 说 有 一 个 Person 类 ， 其 中 包含 了 name 和 age 这 两 个 字段 ， 如 果 想 要 将 它 序列 化 ， 就 可 以 这 
样 写 : 


class Person : Serializable { 
var name = "" 
var age = 0 


这 里 我 们 让 Person 类 实现 了 Serializable 接 口 ,这样 所 有 的 Person 对 象 都 是 可 序列 化 的 
Ts 


然后 在 FirstActivity 中 只 需要 这 样 写 : 


val person = Person() 

person.name = "Tom" 

person.age = 20 

val intent = Intent(this, SecondActivity::class.java) 
intent.putExtra("person data", person) 
startActivity(intent) 
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可 以 看 到 ， 这 里 我 们 创建 了 一 个 Person 的 实例 ， 并 将 它 直接 传 入 了 Intent 的 putExt ra( ) 方 法 
中 。 由 于 Person 类 实现 了 Serializable 接 口 ， 所 以 才 可 以 这 样 写 。 


接 下 来 在 SecondActivity 中 获取 这 个 对 象 也 很 简单 ， 写 法 如 下 : 


val person = intent.getSerializableExtra("person data") as Person 


这 里 调用 了 Intent 的 getSerializableExtra( ) 方 法 来 获取 通过 参数 传递 过 来 的 序列 化 对 
象 ， 接 着 再 将 它 向 下 转型 成 Person 对 象 ， 这 样 我 们 就 成 功 实现 了 使 用 Intent 传 递 对 象 的 功能 。 


需要 注意 的 是 ,这 种 传递 对 象 的 工作 原理 是 先 将 一 个 对 象 序列 化 成 可 存储 或 可 传输 的 状态 , 传 
递 给 另外 一 个 Activity 后 再 将 其 反 序列 化 成 一 个 新 的 对 象 。 虽然 这 两 个 对 象 中 存储 的 数据 完全 一 
致 , 但 是 它们 实际 上 是 不 同 的 对 象 ， 这 一 点 希望 你 能 了 解 清楚 。 

14.2.2 Parcelable 方 式 


除了 Serializable 之 外 ， 使 用 Parcelable 也 可 以 实现 相同 的 效果 ， 不 过 不 同 于 将 对 象 进行 序列 
化 ,Parcelable 方 式 的 实现 原理 是 将 一 个 完整 的 对 象 进行 分 解 ， 而 分 解 后 的 每 一 部 分 都 是 
Intent 所 支持 的 数据 类 型 ， 这 样 就 能 实现 传递 对 象 的 功能 


下 面 我 们 来 看 一 下 Parcelable 的 实现 方式 ,修改 Person 中 的 代码 ， 如 下 所 示 : 


class Person : Parcelable { 
var name = "" 
var age = 0 


override fun writeToParcel(parcel: Parcel, flags: Int) { 
parcel .writeString(name) // 写 出 name 
parcel.writeInt(age) // 写 出 age 


override fun describeContents(): Int { 
return 0 


} 


companion object CREATOR : Parcelable.Creator<Person> { 
override fun createFromParcel(parcel: Parcel): Person { 
val person = Person() 
person.name = parcel.readString() ?:"" // 读 取 name 
person.age = parcel.readInt() // 读 取 age 
return person 


} 


override fun newArray(size: Int): Array<Person?> { 
return arrayOfNulls (size) 
} 
} 


} 


Parcelable 的 实现 方式 要 稍微 复杂 一 些 。 可 以 看 到 ， 首 先 我 们 让 Person 类 实现 了 ParceLabte 
接口 ， 这 样 就 必须 重 写 describeContents() 和 writeToParcel () 这 两 个 方法 。 其 中 
describeContents() 方 法 直接 返回 0 就 可 以 了 ，, 而 在 writeToParcel ( ) 方 法 中 ,我们 需要 
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调用 Parcel 的 writeXxx( ) 方 法 , 将 Person 类 中 的 字段 一 一 写 出 。 注 意 ， 字 符 串 型 数据 就 调用 
writeSstring() 方 法 ， 整 型 数据 就 调用 writeInt () 方 法 ， 以 此 类 推 。 


除 此 之 外 ， 我 们 还 必须 在 Person 类 中 提供 一 个 名 为 CREATOR 的 匿名 类 实现 。 这 里 创建 了 
Parcelable.Creator 接 口 的 一 个 实现 ， 并 将 泛 型 指定 为 Person。 接 着 需要 重 写 
createFromParcel() 和 newArray() 这 两 个 方法 , 在 createFromParcel() 方 法 中 ，, 我们 
要 创建 一 个 Person 对 象 进行 返回 ， 并 读 取 刚才 写 出 的 name 和 age 字段 。 其 中 name 和 age 都 是 
调用 Parcel 的 readXxx( ) 方 法 读 取 到 的 ， 注 意 这 里 读 取 的 顺序 一 定 要 和 刚才 写 出 的 顺序 完全 
相同 。 而 newArray ( ) 方 法 中 的 实现 就 简单 多 了 ， 只 需要 调用 array0fNulls() 方 法 ,并 使 用 
参数 中 传 入 的 size 作 为 数组 大 小 ， 创建 一 个 空 的 Person 数 组 即 可 。 


接 下 来 ， 在 FirstActivity 中 我 们 仍然 可 以 使 用 相同 的 代码 来 传递 Person 对 象 ， 只 不 过 在 
SecondActivity 中 获取 对 象 的 时 候 需 要 稍 加 改动 ， 如 下 所 示 : 


val person = intent.getParcelableExtra("person data") as Person 


注意 ， 这 里 不 再 是 调用 getSerializableExtra() 方 法 , 而 是 调用 
getParcelableExtra() 方 法 来 获取 传递 过 来 的 对 象 ， 其 他 的 地 方 完全 相同 。 


不 过 ， 这 种 实现 方式 写 起 来 确实 比较 复杂 ,为 此 Kotlin 给 我 们 提供 了 另外 一 种 更 加 简便 的 用 法 ， 
但 前 提 是 要 传递 的 所 有 数据 都 必须 封装 在 对 象 的 主 构造 浮 数 中 才 行 。 


修改 Person 类 中 的 代码 ， 如 下 所 示 : 


GParceLize 
class Person(var name: String, var age: Int) : Parcelable 


没 错 ， 就 是 这 么 简单 。 将 name 和 age 这 两 个 字段 移动 到 主 构 造 水 数 中 ， 然 后 给 Pe rson 类 添加 一 
个 GParceLize 注 解 即 可 ,是 不 是 比 之 前 的 用 法 简单 了 好 多 倍 ? 


这 样 我 们 就 把 使 用 Intent 传 递 对 象 的 两 种 实现 方式 都 学 习 完 了 。 对 比 一 下 ，Serializable 的 方式 


较为 简单 ， 但 由 于 会 把 整个 对 象 进行 序列 化 ， 因 此 效率 会 比 Parcelable 方 式 低 一 些 ， 所 以 在 通 
常情 况 下 ， 还 是 更 加 推荐 使 用 Parcelable 的 方式 来 实现 Intent 传 递 对 象 的 功能 。 
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14.3 ”定制 自己 的 日 志 工具 


早 在 1.4 节 中 我 们 就 已 经 学 过 了 Android 日 志 工具 的 用 法 ， 并 且 日 志 工具 贯穿 了 我 们 整 本 书 的 学 
习 。 虽 然 Android 中 自 带 的 日 志 工具 功能 非常 强大 ， 但 也 不 能 说 完全 没有 缺点 ， 例 如 在 打印 日 志 
的 控制 方面 就 做 得 不 够 好 。 


打 个 比方 ， 你 正在 编写 一 个 比较 庞大 的 项 目 ， 期 间 为 了 方便 调试 ， 在 代码 的 很 多 地 方 打印 了 大 
量 的 日 志 。 最 近 项 目 已 经 基本 完成 了 ， 但 是 却 有 一 个 非常 让 人 头疼 的 问题 ， 之 前 用 于 调试 的 那 
些 日 志 ， 在 项 目 正式 上 线 之 后 仍然 会 照常 打印 ， 这 样 不 仪 会 降低 程序 的 运行 效率 ， 还 有 可 能 将 
一 些 机 密 性 的 数据 泄露 出 去 。 


那 该 怎么 办 呢 ? 难道 要 一 行 一 行 地 把 所 有 打印 日 志 的 代码 都 删 掉 吗 ? 显然 这 不 是 什么 好 点 子 ， 
不 仪 费 时 费力 ， 而 且 以 后 你 继续 维护 这 个 项 目的 时 候 可 能 还 会 需要 这 些 日 志 。 因 此 ， 最 理想 的 
情况 是 能 够 自由 地 控制 日 志 的 打印 ， 当 程序 处 于 开发 阶段 时 就 让 日 志 打印 出 来 ， 当 程序 上 线 之 
后 就 把 日 志 屏 菩 掉 。 


看 起 来 好 像 是 挺 高 级 的 一 个 功能 ， 其 实 并 不 复杂 ， 我们 只 需要 定制 一 个 自己 的 日 志 工具 就 可 以 
轻松 完成 了 。 新 建 一 个 LogUtil 单 例 类 ， 代码 如 下 所 示 : 


object LogUtil { 
private const val VERBOSE = 1 
private const val DEBUG = 2 
private const val INFO = 3 
private const val WARN = 4 
private const val ERROR = 5 
private var level = VERBOSE 
fun v(tag: String, msg: String) { 
if (level <= VERBOSE) { 
Log.v(tag, msg) 
} 
fun d(tag: String, msg: String) { 
if (level <= DEBUG) { 
Log.d(tag, msg) 
} 
fun i(tag: String, msg: String) { 
if (level <= INFO) { 
Log.i(tag, msg) 
} 
fun w(tag: String, msg: String) { 


if (level <= WARN) { 
Log.w(tag, msg) 
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} 


fun e(tag: String, msg: String) { 
if (level <= ERROR) { 
Log.e(tag, msg) 


} 


可 以 看 到 ,我们 在 LogUtil 中 首先 定义 了 VERB0OSE、DEBUG、INFO0、WARN、ERROR 这 5 个 整 型 
量 , 并且 它们 对 应 的 值 都 是 递增 的 。 然 后 又 定义 了 一 个 静态 变量 Level ,可 以 将 它 的 值 指定 
为 上 面 5 个 常量 中 的 任意 一 个 。 


接 下 来 ,我 们 提供 了 v()、d()、i()、w()、 e( ) 这 5 个 自 定义 的 日 志 志方 法 ， 在 其 内 部 分 别 调用 
了 Log.v()、Log.d()、Log.i()、Log.w()、Log.e() 这 5 个 方法 来 打印 日 志 ，, 只 不 过 在 这 
些 自 定义 的 方法 中 都 加 入 了 一 个 if 判 断 ， 只 有 当 Level 的 值 小 于 或 等 于 对 应 日 志 志 级 别 值 的 时 
候 ， 才 会 将 日 志 打 印 出 来 。 


这 样 就 把 一 个 自 定 义 的 日 志 工具 创建 好 了 ， i 我 们 可 以 像 使 用 普通 的 日 志 工 具 一 
样 使 用 LogUtil。 比 如 打印 一 行 DEBUG 级 别 的 日 志 可 以 这 样 写 : 


LogUtil.d("TAG", "debug log") 


打印 一 行 WARN 级 别 的 日 志 可 以 这 样 写 : 
LogUtil.w("TAG", "warn log") 


我 们 只 需要 通过 修改 Level 变 量 的 值 ， 就 可 以 自由 地 控制 日 志 的 打印 行为 。 比 如 让 Level 等 于 
VERBOSE 就 可 以 把 所 有 的 日 志 志 都 打印 出 来 ， 让 LeveL 等 于 ERROR 就 可 以 只 打印 程序 的 错误 日 


志 。 


使 用 了 这 种 方法 之 后 ,刚才 所 说 的 那个 问题 也 就 不 复 存 在 了 ， 你 只 需要 在 开发 阶段 将 Level 指 
定 成 VERBOSE , 当 项 目 正 式 上 线 的 时 候 将 Level 指 定 成 ERROR 就 可 以 了 。 
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14.4 调试 Android 程 序 


当 开 发 过 程 中 遇 到 一 些 奇怪 的 bug ,但 又 述 述 定位 不 出 来 原因 的 时 候 ， 最 好 的 解决 办 法 就 是 调试 
了 。 调 试 允 许 我 们 逐 行 地 执行 代码 ， 并 可 以 实时 观察 内 存 中 的 数据 ， 从 而 能 够 比较 轻易 地 查 出 
问题 的 原因 。 那 么 本 节 中 我 们 就 来 学 习 一 下 使 用 Android Studio 调 试 Android 程 序 的 技巧 。 


还 记得 在 第 6 章 的 最 佳 实践 环节 中 编写 的 那个 强制 下 线程 序 吗 ? 就 让 我 们 通过 这 个 例子 来 学 习 一 
下 Android 程 序 的 调试 方法 吧 。 这 个 程序 中 有 一 个 登录 功能 ， 假 如 现在 登录 出 现 了 问题 ， 我 们 就 
可 以 通过 调试 来 定位 问题 的 原因 。 


调试 工作 的 第 一 步 是 添加 断 点 ， 这 里 由 于 我 们 要 调试 登录 部 分 的 问题 ， 所 以 断 点 可 以 加 在 登录 
按钮 的 点 击 事件 里 面 。 添 加 断 点 的 方法 也 很 简单 ， 只 需要 在 相应 代码 行 的 左边 点 击 一 下 就 可 以 
了 ， 如 图 14.2 所 示 。 


Login,setOnCLickListener { it:View! 
@ val account = accountEdit. text.toString() 
val password = passwordEdit,. text.toString() 
// 如 果 账 号 是 admin 且 密码 是 123456， 就 认为 登录 成 功 
if (account == "admin" && password == "123456") { 


图 14.2 添加 断 点 
添加 好 了 断 点 ， 接 下 来 就 可 以 对 程序 进行 调试 了 ， 点 击 Android Studio 顶 部 工具 栏 中 
的 “Debug” 按 钮 (图 14.3 中 最 右边 的 按钮 ) ， 就 会 使 用 调试 模式 来 局 动 程序 。 

mt app 下 GBPixel API29 | PB 益 


图 14.3 工具 栏 上 的 按钮 
等 到 程序 运行 起 来 的 时 候 ， 首 先 会 看 到 一 个 提示 框 ,如 图 14.4 所 示 。 
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Waiting For Debugger 


Application 
BroadcastBestPractice (process 
com.example.broadcastbestpractice) is 


waiting forthe debuggerto attach. 


Force Close 


图 14.4 等 待 调试 器 提示 框 


这 个 框 很 快 就 会 自动 消失 ， 然 后 在 输入 框 里 输入 账号 和 密码 ， 并 点 击 “Login" 按 钮 ， 这 时 
Android Studio 就 会 自动 打开 Debug 窗 口 ， 如 图 14.5 所 示 。 
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三 LoginActivity.kt 


FESSworacoxcvSeETeXCVPSSSWOTO7 
rememberPass. = true 
} 
login. setOnClickListener { it:View 
bd Val account = accountEdit,. text,toString() 


wer Es Or text. ey 


inE 是 123456， 训 
if (account 1 = wadnin" & password = "123456" 请 
val editor = prefs.edit() 
if (rememberPass. ) 让 
editor.putBoolean(" ey ry 
editor.putString("account", account) 
editor.putString(" "password' ，password) 
} else{ 
editor,ctear() 


LoginActivity onCreate() login.setOnClickListener{...} 


Debug: app 守 一 
ly | Debugger | 到 consoe 2 三 全 土 土 土 习 扫 国 豆 2 
后 Frames +” 避 Variables -” 
main"@9,106 in group "ma... | = this = {LoginActivity$oncC $1@9 469} 
it = {AppCompatButton6 78} "androidx.appcompat.widget.AppCompatButton{1 


Cy onClick:26, LoginActivity$onCreate$1 (com.exa! 
rformClick:7140, View (android. view) 
| ) 


= 
农 | dispatchMessage:100, Handler {android.os) [4 
办 


图 14.5 ” Debug 窗口 


接 下 来 每 按 一 次 F8 健 ， 代 码 就 会 向 下 执行 一 行 ， 并 且 通 过 Variables 视 图 还 可 以 看 到 内 存 中 的 数 
据 , 如 图 14.6 所 示 。 


吕 Variables —»" 
+ > Sthis = {LoginActivity$onCreate$1@9469} 

Sit = {AppCompatButton@9478} "androidx.appcompat.widget.AppCompatButton{1: 

辐 account = "abc" 

品 password = "123" 


网 8 


图 14.6 ” Variables 视 图 

可 以 看 到 ， 我 们 从 输入 框 里 获取 的 账号 密码 分 别 是 abc 和 123，, 而 程序 里 要 求 正 确 的 账号 密码 是 
admin 和 123456，, 所 以 登录 才 会 出 现 问题 。 这 样 我 们 就 通过 调试 的 方式 轻松 地 定位 到 了 问 

题 ， 调 试 完 成 之 后 点 击 Debug 窗 口中 的 “Stop" 按 钮 (图 14.7 中 最 下 边 的 按钮 ) 来 结束 调试 即 
可 。 


| 
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图 14.7 结束 调试 按钮 


这 种 调试 方式 虽然 完全 可 以 正常 工作 ,但 在 调试 模式 下 ， 程序 的 运行 效率 将 会 大 大 降低 ， 如 果 
你 的 断 点 加 在 一 个 比较 靠 后 的 位 置 ， 需要 执行 很 多 操作 才能 运行 到 这 个 断 点 ， 那么 前 面 这 些 操 
作 就 会 有 一 些 卡 顿 的 感觉 。 没 关系 ，Android 还 提供 了 另外 一 种 调试 的 方式 ， 可 以 让 程序 随时 进 
入 调试 模式 ， 下 面 我 们 就 来 尝试 一 下 。 

这 次 不 需要 使 用 调试 模式 来 启动 程序 了 ， 就 使 用 正常 的 方式 。 由 于 现在 不 是 在 调试 模式 下 , 程 
序 的 运行 速度 比较 快 ， 可 以 先 把 账号 和 密码 输入 好 ， 然 后 点 击 Android Studio 顶 部 工具 栏 

的 “Attach Debugger to Android Process” 按 钮 (图 14.8 中 最 右边 的 按钮 ) 。 


= 7， 四 


图 14.8 工具 栏 上 的 按钮 
此 时 会 弹出 一 个 进程 选择 提示 框 ， 如 图 14.9 所 示 。 这 里 目前 只 列 出 了 一 个 进程 ,也 就 是 我 们 当 
前 程序 的 进程 。 选 中 这 个 进程 ， 然 后 点 击 “OK” 按 钮 ， 就 会 让 这 个 进程 进入 调试 模式 了 。 


@ ©® Choose Process 


Select a process to attach to: 
| Show all processes 


Debugger: Auto pe 


通 Emulator PixelLAPL29 Android 10 


com.example.broadcastbestpracti 


图 14.9 ”进程 选择 提示 框 


接 下 来 在 程序 中 点 击 “Login” 按 钮 ，Android Studio 同 样 会 自动 打开 Debug 窗 口 ， 之 后 的 流程 
就 是 相同 的 了 。 相 比 起 来 ， 第 二 种 调试 方式 会 比 第 一 种 更 加 灵活 ， 也 更 加 常用 。 
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14.5 深 色 主题 


我 们 一 直 以 来 使 用 的 操作 系统 都 是 以 浅 色 主题 为 主 的 ， 这 种 主题 模式 在 白天 或 者 是 光线 充足 的 
情况 下 使 用 起 来 没有 任何 问题 ， 可 是 在 夜晚 灯光 关闭 的 情况 下 使 用 就 会 显得 非常 刺 腿 。 


于 是 ， 许 多 应 用 程序 为 了 能 够 让 用 户 在 光线 朝 暗 的 环境 下 更 加 舒适 地 使 用 ， 会 在 应 用 内 部 提供 
一 个 一 键 切换 夜间 模式 的 按钮 。 当 用 户 开 启 了 夜间 模式 ， 就 会 将 应 用 程序 的 整体 色调 都 调整 成 
更 加 适合 于 夜间 浏览 的 颜色 。 


不 过 ， 这 种 由 应 用 程序 自发 实现 夜间 模式 的 方式 很 难 做 到 全 局 统一 ， 即 有 些 应 用 可 能 支持 夜间 
模式 ， 有 些 应 用 却 不 支持 。 而 且 重 复 操 作 的 问题 也 很 让 人 头疼 ， 比 如 说 我 在 一 个 应 用 中 开局 了 
夜间 模式 ， 在 另外 一 个 应 用 中 还 需要 再 开局 一 次 ， 关 闭 夜 间 模 式 也 需要 进行 同样 重复 的 操作 。 


因此 , 很 多 开发 者 一 直 呼 吁 ， 希望 Android 能 够 在 系统 层面 支持 夜间 模式 功能 。 终 于 在 Android 
10.0 系 统 中 ，Google 引 入 了 深 色 主题 这 一 特性 ， 从 而 让 夜间 模式 正式 成 为 了 官方 支持 的 功能 。 


或 许 你 会 有 些 疑 惑 ， 这 种 看 上 去 并 没有 太 多 技术 难度 的 功能 ， 为 什么 Android 直 到 10.0 系 统 中 
才 进 行 支持 呢 ? 这 是 因为 仅仅 操作 系统 自身 支持 深 色 主题 是 没有 用 的 ， 还 得 让 所 有 的 应 用 程序 
都 能 够 支持 才 行 ， 而 这 从 来 都 不 是 一 件 容易 的 事情 。 


为 此 ， 我 希望 你 以 后 开发 的 应 用 程序 都 能 够 按照 Android 系 统 的 要 求 对 深 色 主题 进行 很 好 地 支 
持 ， 不 然 当 用 户 开启 了 深 色 主题 之 后 ,只 有 你 的 应 用 还 使 用 的 是 浅 色 主题 的 话 ， 就 会 显得 格格 
不 入 。 


除了 让 有 眼 部 在 夜间 使 用 时 更 加 舒适 之 外 ， 深 色 主 题 还 可 以 减少 电量 消耗 ， 从 而 延长 手机 续航 ， 
是 一 项 非常 有 用 的 功能 。 那 么 接 下 来 ， 我 们 就 开始 学 习 如 何 才 能 让 应 用 程序 支持 深 色 主 题 功 

能 。 

首先 , Android 10.0 及 以 上 系统 的 手机 ， 都 可 以 在 Settings=DisplayDark theme 中 对 深 色 
主题 进行 开启 和 关闭 。 开 启 深 色 主 题 后 ， 系统 的 界面 风格 包括 一 些 内 置 的 应 用 程序 都 会 变 成 深 
色 主 题 的 色调 ， 如 图 14.10 所 示 。 
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图 14.10 ”开启 深 色 主题 后 的 设置 界面 和 拨号 界面 


不 过 ， 如 果 这 时 你 打开 我 们 自己 编写 的 应 用 程序 ， 你 会 发 现 目前 界面 的 风格 还 是 使 用 的 浅 色 主 
题 模式 ， 这 就 和 系统 的 主题 风格 不 同 了 ， 说 明 我 们 需要 对 此 进行 适 配 。 这 里 我 准备 使 用 在 第 12 
章 中 编写 的 MaterialTest 项 目 来 作为 示例 ， 看 一 看 如 何 才能 让 它 更 加 完美 地 适 配 深 色 主题 模 
式 。 


最 简单 的 一 种 适 配 方式 就 是 使 用 Force Dark , 它 是 一 种 能 让 应 用 程序 快速 适 配 深 色 主题 ， 并 且 
几乎 不 用 编写 额外 代码 的 方式 。Force Dark 的 工作 原理 是 系统 会 分 析 浅 色 主 题 应 用 下 的 每 一 层 
View , 并 且 在 这 些 View 绘 制 到 屏幕 之 前 ， 自 动 将 它们 的 颜色 转换 成 更 加 适合 深 色 主 题 的 颜色 。 
注意 ,只 有 原本 使 用 浅 色 主题 的 应 用 才能 使 用 这 种 方式 ， 如 果 你 的 应 用 原本 使 用 的 就 是 深 色 主 
题 ，Force Dark 将 不 会 起 作用 。 


这 里 我 们 尝试 对 MaterialTest 项 目 使 用 Force Dark 转 换 来 进行 举例 。 局 用 Force Dark 功 能 需 
借助 android:forceDarkALLowed 属 性 ， 不 过 这 个 属性 是 从 API 29 , 也 就 是 Android 10.0 
系统 开始 才 有 的 ， 之 前 的 系统 无 法 指定 这 个 属性 。 因 此 ， 我 们 得 进行 一 些 系 统 差异 型 编程 才 
行 。 

右 击 res 目 录 一 New 一 Directory , 创建 一 个 values-v29 目 录 ,然后 右 击 values-v29 目 录 

一 New 一 Values resource file, 创建 一 个 styles.xm|I 文 件 。 接 着 对 这 个 文件 进行 编写 ， 代码 如 
下 所 示 : 


<resources> 
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> 
<item name="colorPrimary">@color/colorPrimary</item> 
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<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 
<item name="android:forceDarkAllowed">true</item> 
</style> 
</resources> 


除了 android:forceDarkALLowed 属 性 之 外 , 其 他 的 内 容 都 是 从 之 前 的 styles.xml 文 件 中 复 
制 过 来 的 。 这 里 给 AppTheme 主 题 增 加 了 android :forceDarkALLowed 属 性 并 设置 为 
true， 说明 现在 我 们 是 允许 系统 使 用 Force Dark 将 应 用 强制 转换 成 深 色 主题 的 。 另 外 ， 


values-v29 目 录 是 只 有 Android 10.0 及 以 上 的 系统 才 会 去 读 取 的 ， 因 此 这 是 一 种 系统 差异 型 编 
程 的 实现 方式 。 


现在 重新 运行 MaterialTest 项 目 ， 效 果 如 图 14.11 所 示 。 


Fruits 


图 14.11 Force Dark 的 运行 效果 


可 以 看 到 ， 虽 然 整 体 的 界面 风格 好 像 确实 变 成 了 深 色 主题 的 模式 ， 可 是 却 并 不 怎么 美观 ， 尤 其 
是 卡片 式 布 局 的 效果 ， 经 过 Force Dark 之 后 已 经 完全 看 不 出 来 了 。 
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Force Dark 就 是 这 样 一 种 简单 粗暴 的 转换 方式 ， 并 且 它 的 转换 效果 通常 是 不 尽 如 人 意 的 。 因 
此 ， 这 里 我 并 不 推荐 你 使 用 这 种 自动 化 的 方式 来 实现 深 色 主题 ， 而 是 应 该 使 用 更 加 传统 的 实现 
方式 一 一 手动 实现 。 


是 的 ， 要 想 实现 最 佳 的 深 色 主 题 效果 ， 不 要 指望 有 什么 神奇 魔法 能 够 一 键 完成 ， 而 是 应 该 针对 
每 一 个 界面 都 进行 浅 色 和 深 色 两 种 主题 的 界面 设计 。 这 听 上 去 好 像 有 点 复杂 ， 不 过 我 们 仍然 有 
一 些 好 用 的 技巧 能 让 这 个 过 程 变 得 简单 。 


在 第 12 章 中 我 们 曾经 学 习 过 ， AppCompat 库 内 置 的 主题 恰好 主要 分 为 浅 色 主题 和 深 色 主题 两 
类 ,比如 MaterialTest 项 目 中 目前 使 用 的 Theme.AppCompat.Light.NoActionBar 就 是 浅 色 
主题 ， 而 Theme.AppCompat.NoActionBar 就 是 深 色 主 题 。 选 用 不 同 的 主题 ， 在 控件 的 默认 
颜色 等 方面 会 有 完全 不 同 的 效果 。 


而 现在 ， 我 们 多 了 一 个 DayNight 主 题 的 选项 。 使 用 了 这 个 主题 后 ， 当 用 户 在 系统 设置 中 开启 深 
色 主 题 时 ， 应 用 程序 会 自动 使 用 深 色 主题 ， 反 之 则 会 使 用 浅 色 主题 。 


下 面 我 们 动手 来 尝试 一 下 吧 。 首 先 删除 values-v29 目 录 及 其 目录 下 的 内 容 ， 然 后 修改 
values/styles.xml 中 的 代码 ， 如 下 所 示 : 


<resources> 
<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.AppCompat.DayNight.NoActionBar"> 
<!-- Customize your theme here. --> 


<item name="colorPrimary">@color/colorPrimary</item> 
<item name="colorPrimaryDark">@color/colorPrimaryDark</item> 
<item name="colorAccent">@color/colorAccent</item> 

</style> 


</resources> 


可 以 看 到 ， 这 里 我 们 将 AppTheme 的 parent 主 题 指 定 成 了 
Theme.AppCompat.DayNight.NoActionBar , 这 是 一 种 DayNight 主 题 。 因 此 ， 在 普通 情况 
下 MaterialTest 项 目 仍然 会 使 用 浅 色 主题 ， 和 之 前 并 没有 什么 区 别 ， 但 是 一 旦 用 户 在 系统 设置 
中 开启 了 深 色 主题 ，MaterialTest 项 目 就 会 自动 使 用 相应 的 深 色 主题 。 


现在 我 们 就 可 以 重新 运行 一 下 程序 , 看 看 使 用 DayNight 主 题 之 后 ，MaterialTest 项 目 默认 的 界 
面 效果 是 什么 样 的 ， 如 图 14.12 所 示 。 
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图 14.12 DayNight 主 题 的 效果 

很 明显 ， 现 在 的 界面 比 之 前 使 用 Force Dark 转 换 后 的 界面 要 好 看 很 多 ， 至 少 卡片 式 布 局 的 效果 
得 到 了 保留 。 

然而 ， 虽 然 现 在 界面 中 的 主要 内 容 都 已 经 自动 切换 成 了 深 色 主 题 ， 但 是 你 会 发 现 标题 栏 和 悬浮 
按钮 仍然 保持 着 和 浅 色 主题 时 一 样 的 颜色 。 这 是 因为 标题 栏 以 及 悬浮 按钮 使 用 的 是 我 们 定义 在 
colors.xml 中 的 几 种 颜色 值 ， 代 码 如 下 所 示 : 


<resources> 
<color name="colorPrimary">#008577</color> 
<color name="colorPrimaryDark">#00574B</color> 
<color name="colorAccent">#D81B60</color> 
</resources> 


这 种 指定 颜色 值 引用 的 方式 相当 于 对 控件 的 颜色 进行 了 硬 编码 , DayNight 主 题 是 不 能 对 这 些 颜 
色 进 行动 态 转换 的 。 
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好 在 解决 方案 也 并 不 复杂 ， 我们 只 需要 进行 一 些 主题 差 异型 编程 就 可 以 了 。 右 击 res 目 录 
New 一 Directory ,创建 一 个 values-night 目 录 ,然后 右 击 values-night 目 录 


New 一 Values resource file ,创建 一 个 colors.xml 文 件 。 接 着 在 这 个 文件 中 指定 深 色 主 题 下 
的 颜色 值 ， 如 下 所 示 : 


<resources> 
<color name="colorPrimary">#303030</color> 
<color name="colorPrimaryDark">#232323</color> 
<color name="colorAccent">#008577</color> 
</resources> 


这 样 的 话 ， 在 普通 情况 下 ， 系 统 仍然 会 读 取 values/colors.xm I 文件 中 的 颜色 值 ， 而 一旦 用 户 开 
启 了 深 色 主题 ， 系 统 就 会 去 读 取 values-night/colors.xmI 文 件 中 的 颜色 值 了 。 


现在 重新 运行 一 下 程序 ， 效果 如 图 14.13 所 示 。 
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图 14.13 调用 深 色 主 题 下 标题 栏 和 悬浮 按钮 的 颜色 
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在 黑白 印刷 模式 下 ， 可 能 没有 什么 特别 明显 的 区 别 ， 但 是 在 实际 的 界面 当中 ,图 14.12 和 图 
14.13 是 完全 不 同 的 深 色 主题 效果 ， 你 可 以 自己 动手 党 试 一 下 。 


虽说 使 用 主题 差异 型 的 编程 方式 几乎 可 以 帮 你 解决 所 有 的 适 配 问题 ， 但 是 在 DayNight 主 题 下 ， 
我 们 最 好 还 是 尽量 减少 通过 硬 编码 的 方式 来 指定 控件 的 颜色 ， 而 是 应 该 更 多 地 使 用 能 够 根据 当 
前 主题 自动 切换 颜色 的 主题 属性 。 比 如 说 黑色 的 文字 通常 应 该 衬托 在 白色 的 背景 下 ， 反 之 白色 
的 文字 通常 应 该 衬托 在 黑色 的 背景 下 ,那么 此 时 我 们 就 可 以 使 用 主题 属性 来 指定 背景 以 及 文字 
的 颜色 ,示例 写法 如 下 : 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="?android:attr/colorBackground"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:Layout gravity="center" 
android:text="Hello world" 
android:textSize="40sp" 
android:textColor="?android:attr/textColorPrimary" /> 


</FrameLayout> 


这 些 主题 属性 会 自动 根据 系统 当前 的 主题 模式 选择 最 合适 的 颜色 值 呈现 给 用 户 ， 效果 如 图 14.14 
所 不。 


Hello world Hello world 


图 14.14 浅 色 主题 和 深 色 主题 下 的 界面 效果 
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另外 ， 或 许 你 还 会 有 一 些 特殊 的 需求 ， 比 如 要 在 浅 色 主 题 和 深 色 主题 下 分 别 执行 不 同 的 代码 逻 
辑 。 对 此 Android 也 是 支持 的 ， 你 可 以 使 用 如 下 代码 在 任何 时 候 判断 当 前 系统 是 否 是 深 色 主题 : 


fun isDarkTheme(context: Context): Boolean { 
val flag = context.resources.configuration.uiMode and 
Configuration.UI MODE NIGHT MASK 
return flag == Configuration.UI MODE NIGHT _ YES 


调用 isDarkTheme () 方 法 ,判断 当前 系统 是 浅 色 主题 还 是 深 色 主 题 ， 然 后 根据 返回 值 执行 不 
同 的 代码 了 逻辑 即 可 。 


另外 ， 由 于 Kotlin 取 消 了 按 位 运算 符 的 写法 ， 改 成 了 使 用 英文 关键 字 ， 因 此 上 述 代码 中 的 and 关 
键 字 其 实 就 对 应 了 Java 中 的 & 运 算 符 ，, 而 Kotlin 中 的 or 关键 字 对 应 了 Java 中 的 | 运算 符 ， xor 关 

键 字 对 应 了 Java 中 的 人 ^ 运 算 符 ， 非常 好 理解 。 

好 了 ，, 关于 深 色 主题 方面 的 知识 ， 讲 到 这 里 就 已 经 差不多 了 。 其 实 整 节 内 容 学 下 来 ， 适 配 深 色 

主题 的 核心 思想 只 有 一 个 ， 那 就 是 要 对 每 个 界面 都 进行 深 色 主题 的 界面 设计 ， 并且 还 要 反复 进 

行 测试 。 在 此 思想 的 基础 之 上 ,我们 可 以 再 利用 本 节 中 学 习 的 一 些 技巧 来 让 适 配 工 作 变 得 更 加 

简单 。 


那么 接 下 来 的 时 间 ， 就 让 我 们 进入 本 书 的 最 后 一 节 Kotlin 课 堂 吧 。 
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14.6 ”Kotlin 课 堂 : Java 与 Kotlin 代 码 之 间 的 转换 


现在 的 你 已 经 掌握 了 关于 Kotlin 方 方面 面 的 内 容 ， 在 本 书 的 最 后 一 节 Kotlin 课 堂 中 ， 我 不 打算 再 
讲解 什么 高 深 复杂 的 知识 点 了 ， 而 是 准备 讲 一 个 许多 人 非常 关心 的 问题 : java 代 码 与 Kotlin 代 码 
之 间 如 何 进 行 转换 。 


由 于 本 书 中 的 所 有 代码 都 是 使 用 Kotlin 语 言 从 零 开始 编写 的 ， 因 此 可 能 你 之 前 并 没有 考虑 过 这 个 
问题 。 但 是 一 定 会 有 许多 老 项 目 之 前 是 使 用 ava 语 言 编 写 的 ， 而 现在 想 要 转换 成 Kotlin 语 言 ， 那 
么 要 怎样 进行 转换 呢 ? 本 节 我 们 就 来 学 习 一 下 如 何 解 决 这 个 问题 。 


首先 ,最 条 的 方法 就 是 对 每 一 行 代码 都 重新 手动 编写 ,但 是 很 明显 ， 这 并 不 是 什么 好 主意 。 事 
实 上 , 将 java 代 码 转 换 成 Kotlin 代 码 ， 在 语法 层面 上 是 有 一 定 规 律 的 ， 而 Android Studio 给 我 
们 提供 了 非常 便利 的 功能 来 一 键 完成 这 种 转换 工作 。 


比如 ， 下 面 是 一 段 使 用 ava 语 言 编写 的 代码 : 


public void printFruits() { 
List<String> fruitList = new ArrayList<>(); 
fruitList.add("Apple"); 
fruitList.add("Banana"); 
fruitList.add("Orange"); 
fruitList.add("Pear"); 
fruitList.add("Grape"); 
for (String fruit : fruitList) { 

System.out.println(fruit); 

} 


} 


如 果 想 要 将 这 段 代 码 转换 成 Kotlin 版 本 ， 其 实 非常 简单 ， 只 需要 复制 这 段 代 码 ， 然 后 在 Android 
Studio 中 打开 任意 一 个 Kotlin 文 件 ， 在 这 里 进行 粘贴 ，Android Studio 就 会 弹出 如 图 14.15 所 
示 的 提示 框 。 


@ 图 Convert Code From Java 


Clipboard content copied from Java file. Do you want to convert it to Kotlin code? 


"| EZ 


Don't show this dialog next time 


图 14.15 将 java 代 码 转换 成 Kotlin 代 码 的 提示 框 


这 个 提示 框 在 询问 我 们 : 即将 粘贴 的 是 一 段 Java 代 码 ， 需 要 将 它 转换 成 Kotlin 代 码 吗 ? 点 
击 “Yes" 按 钮 , Android Studio 就 会 帮 我 们 自动 进行 代码 转换 ,转换 后 的 结果 如 图 14.16 所 示 。 
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fun printFruits() { 
val fruitList = ArrayList<String>() 
fruitList.add("Apple") 
fruitList,.add("Banana") 
fruitList,add("Orange") 
fruitList,add("Pear") 
fruitList,.add("Grape") 
for (fruit in fruitList) { 

printLn(fruit ) 


} 
图 14.16 经 过 Android Studio 转 换 之 后 的 代码 
可 以 看 到 ， 现 在 的 代码 就 变 成 Kotlin 语 言 版 本 的 了 。 


不 过 你 会 发 现 ，Android Studio 虽 然 能 够 帮助 我 们 进行 一 键 代 码 转换 ， 但 是 它 只 会 按照 固定 的 
语法 变化 规律 来 执行 转换 工作 ， 而 不 会 自动 应 用 Kotlin 的 各 种 优秀 特性 。 因 此 ， 依靠 这 种 自动 转 
换 工 具 只 能 实现 基础 版 的 Kotlin 语 法 ， 细 节 方 面 的 代码 优化 还 是 得 靠 我 们 手动 完成 。 比 如 ， 使 用 
如 下 代码 来 实现 同样 的 功能 明显 是 一 种 更 好 的 写法 : 


fun printFruits() { 
val fruitList = mutableList0f("Apple", "Banana", "Orange", "Pear", "Grape") 


for (fruit in fruitList) { 
println(fruit) 


上 述 方法 是 将 一 段 java 代 码 转换 成 Kotlin 代 码 的 方式 。 另 外 ， 我 们 还 可 以 直接 将 一 个 Java 文件 
以 及 其 中 的 所 有 代码 一 次 性 转换 成 Kotlin 版 本 。 具 体操 作 方法 是 ,首先 在 Android Studio 中 打 
开 该 Jjava 文 件 ， 然后 点 击 导 航 栏 中 的 Code 一 Convert java File to Kotlin File ， 如 图 14.17 所 
示 。 
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Analyze Refactor Build Run 


Generate... EN 
Surround With... VT 
Unwrap/Remove... 介绍 区 
Completion Pp 
Folding > 
Insert Live Template... $6J 
Surround with Live Template... $yJ 
Comment with Line Comment $8/ 
Comment with Block Comment 8%/ 
Reformat Code VL 
Show Reformat File Dialog tO%L 
Auto-Indent Lines We 
Optimize Imports i 0 
Rearrange Code 

Move Statement Down 仓 引 } 
Move Statement Up 他 3 
Move Line Down 全 4 
Move Line Up Re 


图 14.17 将 java 文 件 转换 成 Kotlin 文 件 


将 Java 代 码 一 键 转换 成 Kotlin 代 码 主 要 就 是 通过 以 上 两 种 方式 ， 那 么 你 可 能 会 好 奇 ，Kotlin 代 码 
又 该 如 何 转换 成 java 代 码 呢 ? 很 遗憾 的 是 ,Android Studio 并 没有 提供 类 似 的 转换 功能 ， 因 为 
Kotlin 拥 有 许多 java 中 并 不 存在 的 特性 ， 因 此 很 难 执行 这 样 的 一 键 转换 。 


不 过 ， 我 们 却 可 以 先 将 Kotlin 代 码 转 换 成 Kotlin 字 节 码 ， 然 后 再 通过 反 编 译 的 方式 将 它 还 原 成 
Java 代码 。 这 种 反 编 译 出 来 的 代码 可 能 无 法 像 正常 编写 的 java 代 码 那 样 直接 运行 ， 但 是 非常 有 
利于 帮助 我 们 理解 诸多 Kotlin 特 性 背后 的 实现 原理 。 

举 一 个 开发 中 经 常会 用 到 的 例子 。kotlin-android-extensions 插 件 可 以 大 大 简化 Activity 中 的 
代码 编写 ,因为 我 们 不 再 需要 通过 调用 fijndViewById() 方 法 去 获取 控件 的 实例 了 ， 可 是 你 
好 奇 过 这 个 功能 是 如 何 实 现 的 吗 ? 


我 们 先 来 回顾 一 下 这 种 写法 ， 如 图 14.18 所 示 。 
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class FirstActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R,. layout.activity_first) 
button,. setOnClickListener { it:View! 
Toast,makeText( context: this, 


} 


text: "You clicked Button", Toast,.LENGTH_SHORT).show() 


} 


图 14.18 button 不 需要 调用 findViewById ( ) 方 法 就 能 直接 使 用 


只 要 activity frst.xml 布 局 中 定义 了 一 个 id 值 为 button 的 按钮 ， 我 们 就 可 以 在 Activity 中 直接 
使 用 button 这 个 变量 ， 既 不 用 进行 定义 ， 也 不 用 先 调 用 findViewById ( ) 方 法 对 button 变 量 
进行 赋值 。 

这 么 神奇 的 功能 ，kotlin-android-extensions 插 件 又 是 怎样 实现 的 呢 ? 此 时 就 可 以 先 将 这 段 代 
码 转 换 成 Kotlin 字 节 码 ， 然 后 再 通过 反 编 译 的 方式 将 它 还 原 戌 ava 代 码 ， 以 此 来 观察 kotlin- 
android-extensions 插 件 背 后 的 实现 原理 。 


具体 操作 方式 是 ， 点 击 Android Studio 导 航 栏 中 的 Tools>KotlinShow Kotlin Bytecode 
会 显示 如 图 14.19 所 示 的 窗口 。 
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Kotlin Bytecode 家 一 


Decompile Inline 园 optimization 园 Assertions [ | IR 


// ================CO1/AexampLe/materialtest/FirstActivi 
// class version 58.8 (1568) 

// access flags Ox31 

public final class com/example/materialtest/FirstActivi 


// access flags Ox4 
protected onCreate(Landroid/os/Bundle; )V 
// annotable parameter count: 1 (visible) 


// annotable parameter count: 1 (invisible) 
@Lorg/jetbrains/annotations/Nullable;() // invisibl 
Lg 

LINENUMBER 11 LO 

ALOAD 8 

ALOAD 1 

INVOKESPECIAL androidx/appcompat/app/AppCompatActiv 
EE 

LINENUMBER 12 L1 

ALOAD 0 


LDC -1300024 

INVOKEVIRTUAL com/example/materialtest/FirstActivit 
L2 

LINENUMBER 13 L2 

ALOAD 0 

GETSTATIC com/example/materialtest/R$id,.button : I 
INVOKEVIRTUAL com/example/materialtest/FirstActivit 
CHECKCAST android/widget/Button 

NEW com/example/materialtest/FirstActivity$onCreate 
DUP 

ALOAD 0 

INVOKESPECIAL com/example/materialtest/FirstActivit 
CHECKCAST android/view/View$OnClickListener 
INVOKEVIRTUAL android/widget/Button,setOnClickListe 
L3 

LINENUMBER 16 L3 

RETURN 

L4 

LOCALVARIABLE this Lcom/example/materialtest/FirstA 
LOCALVARIABLE savedInstanceState Landroid/o0s/Bundle 
MAXSTACK = 4 

MAXLOCALS = 2 


图 14.19 ”显示 Kotlin 字 节 码 的 窗口 


这 个 窗口 中 显示 的 内 容 就 是 刚才 那 段 Kotlin 代 码 所 对 应 的 字 节 码 了 ， 是 不 是 觉得 完全 看 不 懂 ? 没 


有 关系 ， 因 为 你 也 没有 必要 将 它们 看 懂 。 现 在 


司 
只 需 


要 点 击 这 个 窗口 左上 角 的 “Decompile" 按 


钮 ， 就 可 以 将 这 些 Kotlin 字 节 码 反 编译 成 ava 人 代码， 结果 如 图 14.20 所 示 。 
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public final class FirstActivity extends AppCompatActivity { 
private HashMap _$_findViewCache; 


protected void onCreate(@Nullable Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
this,setContentView(-1300024) ; 
((Button)this,_$_findCachedViewById(id,.button)),.setOnClickListener((OnClickListener)((OnClickListener) (it) » { 
Toast .makeText( (Context)FirstActivity, this, (Char )"You clicked Button"， duration: 0).show(); 
})); 
} 


public View _$_findCachedViewById(int varl) { 
if (this, $ findViewCache == null) { 
this, _$_findViewCache = new HashMap(); 


} 


View var2 = (View)this. $ findViewCache.get(varl); 
if (var2 == null) { 

yar2 = this,findViewById(varl); 

this, $ findViewCache,put(varl, var2); 


return var2; 


public void _$_clearFindViewByIdCache() { 
if (this, $ findViewCache != null) { 
this, $_findViewCache.clear(); 


} 
} 


图 14.20 反 编 译 后 的 ava 代 码 


通过 这 上段 Java 代 码 ,我们 就 可 以 大 致 分 析出 kotlin-android-extensions 插 件 背 后 的 实现 原理 。 

原来 它 会 在 Activity 中 自动 生成 一 个 $_findCachedViewById() 方 法 ( 取 这 么 奇怪 的 名 字 是 
为 了 防止 和 我 们 自己 定义 的 方法 重 名 ) ， 在 这 个 方法 中 根据 传 入 的 id 值 调用 findViewById() 

方法 来 查询 并 获取 控件 的 实例 ， 然 后 使 用 HashMap 对 该 实例 进行 缓存 ， 这样 下 次 就 没 必要 重复 
进行 查询 了 。 

接 下 来 在 onCreate( ) 方 法 中 ， 只 需要 调用 $ findCachedViewById() 方 法 获得 button 按 

钮 的 实例 ， 再 调用 set0nClickListener() 方 法 对 按钮 的 点 击 事件 进行 注册 即 可 。 


hm me a 


怎么 样 ， 揭 秘 了 kotlin-android-extensions 搬 件 背后 的 实现 原理 有 没有 觉得 收获 满 满 呢 ? 事实 
上 ， 通 过 这 种 技巧 我 们 可 以 了 解 许多 Kotlin 特 性 背后 的 实现 原理 ， 这 对 于 你 加 深 对 Kotlin 这 门 语 
言 的 理解 会 很 有 帮助 。 

这 样 我 们 就 将 java 与 Kotlin 代 码 之 间 相 互 转换 的 技巧 都 学 习 完 了 ， 同 时 本 书 最 后 一 节 Kotlin 课 党 
的 内 容 也 到 此 为 止 +。 现 在 你 的 Kotlin 水 平 已 经 大 有 所 成 ， 基 本 可 以 满足 绝 大 多 数 Kotlin 项 目 中 
的 技术 要 求 ， 唯 一 所 欠缺 的 或 许 就 是 多 写 多 练 。 那 么 为 了 能 让 你 多 加 练习 ， 接 下 来 我 准备 了 两 
个 章节 的 实战 内 容 ， 这 绝对 是 你 不 想 错过 的 部 分 。 不 过 首先 ， 我 们 来 对 整 本 书目 前 所 学 的 全 部 
知识 做 个 快速 的 总 结 吧 。 


1 如 果 希 望 学 习 更 多 Kotlin 知 识 ， 可 以 阅读 专门 介绍 Kotlin 的 图 书 ， 例 如 图 灵 公 司 出 版 的 《Kotlin 编 程 权威 指南 》。 
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14.7 总 结 


整整 14 章 的 内 容 你 已 经 全 部 学 完了 ! 本 书 的 所 有 知识 点 也 到 此 结束 ， 是 不 是 感觉 有 些 激动 呢 ? 
下 面 就 让 我 们 来 回顾 和 总 结 一 下 这 么 久 以 来 学 过 的 所 有 东西 吧 。 


这 14 章 的 内 容 不 算 很 多 ， 但 已 经 把 Android 中 绝 大 部 分 比较 重要 的 知识 点 覆盖 到 了 。 我 们 从 拱 
建 开发 环境 开始 学 起 ， 后 面 这 步 学 习 了 四 大 组 件 、UI、Fragment、 数 据 存储 、 多 媒体 、 网 络 、 
Material Design、jJetpack 等 内 容 ， 本 章 中 又 学 习 了 如 全 局 获取 Context、 定 制 日 志 工 具 、 调 
试 程 序 、 深 色 主 题 等 高 级 技巧 ， 相 信 你 已 经 从 一 名 初学 者 蚁 变 成 一 位 Android 开 发 好 于 了 。 


另外 ， 我 们 还 通过 一 章 快速 入 门 章节 ， 外 加 12 节 Kotlin 课 堂 的 内 容 ， 非 常 全 面 地 学 习 了 Kotlin 方 
方面 面 的 知识 ， 并 且 整 本 书 中 所 有 的 示例 程序 都 是 使 用 Kotlin 语 言 编 写 的 ， 相 信 现 在 你 对 这 门 语 
言 已 经 相当 熟悉 了 。 


不 过 ,虽然 你 已 经 储备 了 足够 多 的 知识 ， 并 掌握 了 很 多 的 最 佳 实践 技巧 ， 但 是 还 从 来 没有 真正 
开发 过 一 个 完整 的 项 目 。 也 许 在 将 所 有 学 到 的 知识 混合 到 一 起 使 用 的 时 候 ， 你 会 感到 有 些 手 足 
无 措 。 因 此 ， 前 进 的 脚步 仍然 不 能 停 下 ， 下 一 章 中 我 们 会 结合 前 面 章 节 所 学 的 内 容 ， 一 起 开发 
一 个 天 气 预 报 App。 银 炼 的 机 会 可 于 万 不 能 错过 ， 赶 快 进入 下 一 章 吧 。 
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第 15 章 进入 实战 ,开发 一 个 天 气 预 报 App 


我 们 将 要 在 本 章 中 编写 一 个 功能 较为 完整 的 天 气 预报 App， 学习 了 这 么 久 的 Android 开 发 ， 现 在 
终于 到 考核 验收 的 时 候 了 。 那 么 第 一 步 我 们 需要 给 这 个 软件 起 个 好 听 的 名 字 ， 这 里 就 叫 它 
SunnyWeather 吧 。 确 定 了 名 字 之 后 ， 下面 就 可 以 开始 动手 了 .。 
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15.1 功能 需求 及 技术 可 行 性 分 析 


在 开始 编码 之 前 ， 我们 需要 先 对 程序 进行 需求 分 析 ， 想 一 想 SunnyWeather 中 应 该 具备 哪些 功 
能 。 将 这 些 功能 全 部 整理 出 来 之 后 ， 我们 才 好 动手 去 一 一 实现 。 这 里 我 认为 SunnyWeather 中 
至 少 应 该 具备 以 下 功能 : 


。 可 以 搜索 全 球 大 多 数 国家 的 各 个 城市 数据 ; 

。 可 以 查看 全 球 绝 大 多 数 城市 的 天 气 信息 ; 

。 可 以 自由 地 切换 城市 ， 查 看 其 他 城市 的 天 气 ; 
。 可 以 手动 刷新 实时 的 天 气 。 


虽然 看 上 去 只 有 4 个 主要 的 功能 点 ， 但 如 果 想 要 全 部 实现 这 些 功 能 ， 却 需要 用 到 Ul、 网络、 数据 
存储 、 异 步 处 理 等 技术 ， 因 此 还 是 非常 考验 你 的 综合 应 用 能 力 的 。 不 过 好 在 这 些 技术 在 前 面 的 
章节 中 我 们 全 部 都 学 习 过 了 “， 只 要 你 学 得 用 心 ， 相信 完 成 这 些 功 能 对 你 来 说 并 不 难 。 


分 析 完 了 需求 之 后 ， 接 下 来 就 要 进行 技术 可 行 性 分 析 了 。 宫 无 疑问 ， 当 前 最 重要 的 问题 就 是 ， 
我 们 如 何 才能 得 到 全 球 大 多 数 国家 的 城市 数据 ， 以 及 如 何 才 能 获取 每 个 城市 的 天 气 信息 。 比 较 
遗憾 的 是 ， 现 在 网 上 免费 的 天 气 预 报 接口 已 经 越 来 越 少 ， 很 多 之 前 可 以 使 用 的 接口 也 慢 慢 关闭 
了 。 为 了 能 够 给 你 提供 功能 强大 且 长 期 稳定 的 服务 肴 接口 ， 本 书 最 终 选 择 了 彩云 天 气 。 
彩云 天 气 是 一 款 非 常 出 色 的 天 气 预报 App， 本章 中 我 们 即将 编写 的 App 就 是 以 彩云 天 气 为 范本 
的 。 另 外 ， 彩 云天 气 的 开放 API 还 提供 了 全 球 100 多 个 国家 的 城市 数据 ， 以 及 每 个 城市 的 实时 天 
气 预 报信 息 ， 并 且 这 些 API 接 口 是 长 期 稳定 且 可 用 的 ， 从 而 帮 你 把 前 进 的 道路 都 铺 平 了 。 不 过 彩 
云天 气 的 开放 API 并 不 是 可 以 无 限 次 免费 使 用 的 ， 而 是 每 天 最 多 提供 1 万 次 的 免费 请 求 ， 当 然 ， 
这 对 于 学 习 而 言 已 经 是 相当 充足 了 。 


那么 下 面 我 们 就 来 看 一 下 彩云 天 气 提供 的 这 些 开放 API 的 具体 用 法 。 首 先 你 需要 注册 一 个 账号 ， 
注册 地 址 是 https://dashboard.caiyunapp.com/。 


然后 登录 刚刚 注册 的 账号 ， 并 完善 以 下 账户 信息 ， 如 图 15.1 所 示 。 
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1. 账户 信息 2. 令 牌 的 申请 信息 3. 完成 


账户 类 型 * 个 人 姓名 / 非 盈利 组 织 名 切换 为 企业 


个 人 姓名 /组 织 名 : * 
请 填写 完整 名 称 


联系 名 : * 


联系 电话 : * 


图 15.1 完善 账户 信息 


接着 点 击 “ 下 一 步 "来 申请 令 牌 信息 。 原 则 上 ， 彩云 天气 要 求 填 入 应 用 的 实际 下 载 链 接 才 能 申请 
令 牌 信息 ， 不 过 由 于 我 们 的 App 还 在 开发 中 ,因此 可 以 在 应 用 开发 情况 这 一 栏 写 明 实际 的 原 
, 比如 参照 图 15.2 所 示 的 写法 。 


1. 账 户 信息 2. 令 牌 的 申请 信息 3. 完 成 


应 用 类 别 : 彩云 天 气 API 彩云 小 译 API 
应 用 名 : SunnyWeather 
应 用 链接 : 


如 果 您 开发 的 应 用 中 使 用 到 开放 平台 的 数据 接口 ， 且 已 在 loS/ 安 卓 应 用 市 场 
架 ， 请 提交 应 用 所 在 商店 地 址 (如 果 是 web 应 用 请 提供 网 址 ， 如 果 是 pc 端 


不， 


应 用 ， 请 提供 下 载 地 址 ) 
应 用 开发 情况 : 第 一 行 代码 中 的 实战 项 目 开发 
pA 


如 果 应 用 仍 处 于 开发 过 程 中 ， 请 在 此 栏 位 里 说 明 ， 暂 可 不 需要 提供 相关 文 
件 ， 待 上 线 后 再 提交 即 可 。 


图 15.2 申请 令 牌 信息 


然后 点 击 “ 提 交 ”, 等 待 审核 通过 即 可 。 审 核 的 时 长 并 不 固定 ， 但 一 般 会 在 一 个 工作 日 内 通过 ，。 
在 审核 通过 之 后 ， 点 击 进入 “我 的 令 牌 "界面 ， 就 能 查看 你 申请 到 的 令 牌 了 ， 如 图 15.3 所 示 。 
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令 牌 列表 


应 用 名 应 用 类 别 令 牌 统计 API 文档 套餐 用 途 
SunnyWeather BNBRvBveaD2V... 查看 试用 查看 严 购 买 修改 


图 15.3 可 用 于 请 求 API 接 口 的 令 牌 值 
具体 的 令 牌 值 以 及 每 天 剩余 的 可 请 求 次 数 ， 可 以 点 击 令 牌 链接 进行 查看 。 


有 了 这 个 令 牌 值 之 后 ， 我 们 就 能 使 用 彩云 天 气 提供 的 各 种 API 接 口 了 ， 比 如 访问 如 下 接口 地 址 即 
可 查询 全 球 绝 大 多 数 城市 的 数据 信息 。 


https://api.caiyunapp.com/v2/place?query= 北 京 &token={token}&lang=zh_CN 


query 参 数 指定 的 是 要 查询 的 关键 字 ，token 参 数 传 入 我 们 刚才 申请 到 的 令 牌 值 即 可 。 服 务 器 
会 返回 我 们 一 段 JSON 格 式 的 数据 ， 大 致 内 容 如 下 所 示 : 


{" status":"ok","query": "北京 "， 

“places": 
{"name" ey "location":{"lat":39.9041999, "lng":116.4073963}, 
"formatted address": "中 国 北京 市 "}， 
{"name" : "北京 西 站 "，, "Location":{"lat":39.89491, "lng":116.322056}， 
"formatted_address":" 中 国 北京 市 丰台 区 莲花 池 东 路 118 号 "}， 
{"name": "北京 南 站 "，, "location":{"lat":39.865195,"lng":116.378545}， 
"formatted address":" 中 国 北京 市 丰台 区 永 外 大 街 车 站 路 12 号 "}， 
{"name": "北京 站 (地 铁 站 )","location":{"lat":39.904983,"lng":116.427287}， 
"formatted_ address": "中 国 北京 市 东城 区 2 号 线 "} 
]} 


status 代 表 请 求 的 状态 ,ok 表示 成 功 。places 是 一 个 JSON 数 组 ,会 包含 几 个 与 我 们 查询 的 关 
键 字 关系 度 比 较 高 的 地 区 信息 。 其 中 name 表 示 该 地 区 的 名 字 ，Location 表 示 该 地 区 的 经 纬 
度 , formatted address 表示 该 地 区 的 地 址 。 


过 这 种 方式 ， 我 们 就 能 把 全 球 绝 大 多 数 城市 的 数据 信息 获取 到 了 。 那 么 解决 了 城市 数据 的 获 
我 们 怎样 才能 查看 具体 的 天 气 信息 呢 ? 这 个 时 候 就 得 使 用 彩云 天 气 的 另外 一 个 API 接 口 了 ， 
接口 地 址 如 下 : 


https://api.caiyunapp.com/v2.5/{token}/116.4073963,39.9041999/realtime.json 


token 部 分 仍然 传 入 我 们 刚才 申请 到 的 令 牌 值 ， 紧 接着 传 入 一 个 纬度 和 经 度 之 间 
要 用 过 号 隔 开 ， 这 样 服务 右 就 会 把 该 地 区 的 实时 天 气 信息 以 SON 格 式 返 回 给 我 们 了 。 不 过 , 由 
于 返回 的 数据 比较 复杂 ,这 里 我 做 了 一 下 精简 处 理 ， 如 下 所 示 : 


"status": "ok", 
"result": { 
"realtime": { 
"temperature": 23.16, 
"skycon": "WIND", 
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"air quality": { 
"agi": { "chn": 17.0 } 


} 
} 
} 


realtime 中 包含 的 就 是 当前 地 区 的 实时 天 气 信息 , 其 中 temperature 表 示 当 前 的 温度 ， 
skycon 表 示 当 前 的 天 气 情况 。 而 air_quality 中 会 包含 一 些 空气 质量 的 数据 ， 当然 返 回 的 空 
气质 量 数据 有 很 多 种 ， 这 里 我 准备 使 用 aqi 的 值 作为 空气 质量 指数 显示 在 界面 上 。 


以 上 接口 可 以 用 来 获取 指定 地 区 实时 的 天 气 信息 ， 而 如 果 想 要 获取 未 来 几 天 的 天 气 信息 ， 还 要 
借助 另外 一 个 API 接 口 ， 接 口 地 址 如 下 : 


https://api.caiyunapp.com/v2.5/{token}/116.4073963,39.9041999/daily.json 


很 简单 ， 只 需要 将 接口 最 后 的 realtime .json 改 成 了 daily .json 就 可 以 了 ， 其 他 部 分 都 是 相 
同 的 。 这 个 接口 返回 的 数据 也 比较 复杂 ， 我 还 是 进行 了 一 下 精简 处 理 ， 如 下 所 示 : 


"status": "ok", 
"result": { 
"daily": { 
"temperature": [ {"max": 25.7, "min": 20.3}, ... ]， 
"skycon": [ {"value": "CLOUDY", "date":"2019-10-20T00:00+08:00"}，... ]， 


"life index": { 
"coldRisk": [ {"desc":“" 易 发 "}，...]， 
"carWashing": [ {"desc": "适宜 "},，... 】， 
"ultraviolet": [ {"desc": "无 "}, ... ]，, 
"dressing": [ {"desc": "舒适" >. 


} 
} 
} 


} 


daiLy 中 包含 的 就 是 当前 地 区 未 来 几 天 的 天 气 信息 ，temperature 表 示 未 来 几 天 的 温度 值 ， 
skycon 表 示 未 来 几 天 的 天 气 情况 。 而 Life_index 中 会 包含 一 些 生活 指数 ，coLdRisk 表 示 感 
冒 指 数 ,carwWashing 表 示 洗 车 指数 ，uLt raviotLet 表 示 紫 外 线 指数 , dressing 表 示 穿 衣 指 
数 。 这 个 接口 中 返回 的 数据 大 部 分 是 数组 格式 的 ， 这 一 点 需要 格外 注意 。 


接 下 来 我 们 只 需要 对 获得 的 JSON 数 据 进行 解析 就 可 以 了 ， 这 对 于 你 来 说 应 该 很 轻松 了 吧 ? 
确定 了 技术 完全 可 行 之 后 ， 接 下 来 就 可 以 开始 编码 了 。 不 过 别 着 急 ， 我们 准备 让 


SunnyWeather 成 为 一 个 开源 软件 ， 并 使 用 GitHub 进 行 代码 托管 ， 因 此 先 让 我 们 进入 本 书 最 后 
一 次 的 Git 时 间 。 
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15.2 ”Git 时 间 : 将 代码 托管 到 GitHub 上 


经 过 前 面 几 章 的 学 习 ， 相 信 你 已 经 可 以 非常 熟练 地 使 用 Git 了 。 本 节 依 然 是 Git 时 间 ， 这 次 我 们 将 
会 把 SunnyWeather 的 代码 托管 到 GitHub 上 面 。 


GitHub 是 全 球 最 大 的 代码 托管 网 站 ,主要 就 是 通过 Git 来 进行 版 本 控制 的 。 任 何 开源 软件 都 可 以 
免费 地 将 代码 提交 到 GitHub 上 ， 以 零 成 本 的 代价 进行 代码 托管 。GitHub 的 官网 地 址 是 
https://github.com/。 官 网 的 首页 如 图 15.4 所 示 。 


Built for 


developers 


Gith 


图 15.4” GitHub 首页 


首先 你 需要 有 一 个 GitHub 账 号 才能 使 用 GitHub 的 代码 托管 功能 ， 点击“Sign up for 
GitHub” 按 钮 进行 注册 ,然后 填 入 用 户 名 、 邮 箱 和 密码 ， 如 图 15.5 所 示 。 
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Create your account 


Username * 


guolindev WA 


Email address * 


sinyu****07@163.com AM 


Password * 


wercase letter. 


So 


Make sure it's at least 15 characters OR at least 8 characters including a number and a | 


Learn more. 


Next: Select a plan 


图 15.5 注册 账号 


点 击 “Next: Select a plan" 按 钮 会 进入 选择 个 人 计划 界面 ， 这 里 我 们 并 不 需要 使 用 太 多 高 级 的 
功能 ， 所 以 直接 选择 最 左边 的 免费 计划 就 可 以 了 ， 如 图 15.6 所 示 。 


Pick the plan that's right for you 


Individuals Teams 
有 中 和 
三 "A [ 岛 3 
Team Enterprise 


$0 ,。 


The basics of GitHub for every 
developer 


v Unlimited public repositories 

v Unlimited private 
repositories 

~ Limited to 3 collaborators 
for private repositories 

v lssues and bug tracking 

v Project management 


图 15.6 选择 免费 计划 


Pro 
$7 USD 


Per month 


Pro tools for developers with 
advanced requirements 


« Includes everything in Free 


~ Unlimited collaborators 
~ GitHub Pages 

Wikis 

~ Protected branches 

~ Code owners 

~ Repository insights 


$9 ,。 


Per user / month 


Starts at $25 and includes 5 
Users 


Advanced collaboration and 
management tools for teams 


v Unlimited public repositories 

~ Unlimited private 
repositories 

v Team access controls 

v User management and billing 

v lssues and bug tracking 

v Project management 

v Advanced tools and insights 


Free for 
Open source teams 
Academic faculty 
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$21 USD 


Per user / month 


Security compliance, and 
deployment controls for 
organizations 


Start your 14-day free trial 


« Includes everything in Team 


~ Self-hosted or cloud-hosted, 
or both 

~ SAML single sign-on 

w Access provisioning 

~ Invoice billing 

~ 99.95% uptime SLA 

Y Simplified account 
administration 

~ Unified search and 
contributions 

v Priority Support 

~ Advanced auditing 


接着 会 进入 一 个 问卷 调查 界面 ， 如 图 15.7 所 示 。 


How much programming experience do you have? 


None A little 
1 don't program at all I'm new to programming 
A moderate amount Alot 
I'm somewhat experienced I'm very experienced 


What do you plan to use GitHub for? 
(Select up to 3) 


Pi 
ry EA ; 
sh 
Learn Git and Host a project 
Learn to code 
GitHub (repository) 
二 = -去 中 Ra 
国 I 可 
I 
Create a website Find and 
with GitHub contribute to Senool and 


pages open source student projects 


Use the GitHub 


API Other 


lam interested in: 


We'll connect you with communities and projects that fit your 
interests. 


For example: webapp ocaml ajax 


Complete setup 


Skip this step 


图 15.7 问卷 调查 界面 


如 果 你 对 这 个 有 兴趣 就 填写 一 下 ， 没 兴趣 的 话 直接 点 击 最 下 方 的 “Skip this step” 跳 过 就 可 以 
Ts 


这 样 我 们 就 把 账号 注册 好 了 ， 到 你 填写 的 邮箱 中 验证 一 下 即 可 激活 账号 。 重 新 打开 GitHub 官 
网 ,会 自动 跳 转 到 你 的 GitHub 个 人 主页 ， 如 图 15.8 所 示 。 


®0@ © otHub x ee 


€ C @ github.com 


© Pull requests lIssues Marketplace Explore 


Repositories 
Your most active repositories will appear here, 
Create a repository or explore repositories. 


Learn Git and GitHub without any code! 


Using the Hello World guide, you'll create a repository, start a branch, 
write comments, and open a pull request. 


Read the guide Start a project 


图 15.8 GitHub 个 人 主页 
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现在 就 可 以 点 击 “Start a project” 按 钮 来 创建 一 个 版 本 库 了 ， 这 里 我 们 将 版 本 库 命名 
为 “SunnyWeather”，, 然后 勾 选 “Initialize this repository with a README”，, 并 添加 一 个 
Android 项 目 类 型 的 .gitignore 文 件 ， 以 及 使 用 Apache License 2.0 来 作为 SunnyWeather 的 
开源 协议 ， 如 图 15.9 所 示 。 
Owner Repository name * 
[| guolindev ~ / SunnyWeather Vv 
Great repository names are short and memorable. Need inspiration? How about bookish-octo-pancake? 


Description (optional) 


© Public 


FH Anyone can see this repository. You choose who can commit 
MD Private 


L_ You choose who can see and commit to this repository 


Skip this step if you're importing an existing repository. 


Initialize this repository with a README 
This will let you immediately clone the repository to your computer. 


Add .gitignore: Android ~ Add alicense: Apache License 2.0Y 四 


图 15.9 创建 版 本 库 


接着 点 击 “Create repository" 按 钮 ，SunnyWeather 这 个 版 本 库 就 创建 完成 了 ， 如 图 15.10 所 
示 。 版 本 库 的 主页 地 址 是 https://github.com/guolindev/SunnyWeather。 


加 1commit B 1branch 0 releases M2 1 contributor 史 Apache-2.0 


Branch: master v New pull request Create newfile Uploadfiles Find file Clone or download 


~ guolindev Initial commit Latest commit 7093ada 1 minute ago 


司 .gitignore Initial commit 1 minute ago 
LICENSE Initial commit 
) README.md Initial commit minute 


国 README.md 


SunnyWeather 


图 15.10 版 本 库 主 页 


可 以 看 到 ，GitHub 已 经 自动 帮 有 我 们 创建 了 .gitignore、LICENSE 和 README.md 这 3 个 文件 ， 
其 中 编辑 README.md 文 件 中 的 内 容 可 以 修改 SunnyWeather 版 本 库 主 页 的 描述 。 


创建 好 了 版 本 库 之 后 ， 接 下 来 我 们 就 需要 创建 SunnyWeather 这 个 项 目 了 。 在 Android Studio 
中 新 建 一 个 Android 项 目 ， 项 目 名 叫 作 SunnyWeather ， 和 帮 骨 作 
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com.sunnyweather.android , 如 图 15.11 所 示 。 
人 9 Create New Project 
Configure your project 


Name 


SunnyWeather 


Package name 


Save location 


ers/guolin/AndroidStudioProjects/AndroidFirstLine/SunnyWeather 


Language 


Kotlin 


Minimum APl level API 21: Android 5.0 (Lollipop) v 
Empty Activity @ Your app will run on approximately 85.0% of devices. 


Help me choose 


This project will support instant apps 


Creates a new empty activity 


Cancel Previous |_Finish | 


图 15.11 创建 SunnyWeather 项 目 


接 下 来 的 一 步 非常 重要 ,我 们 需要 将 远程 版 本 库 克 隆 到 本 地 。 首 先 必须 知道 远程 版 本 库 的 Git 地 
址 ,点 击 版 本 库 主页 中 的 “Clone or download” 按 钮 就 能 够 看 到 了 ， 如 图 15.12 所 示 。 


Create new file Upload files Find file Clone or download ~ 


Clone with HTTPS @ Use SSH 
Use Git or checkout with SVN using the web URL. 


https://github,com/guolindev/SunnyWese 良 


Open in Desktop Download ZIP 


图 15.12 查看 版 本 库 的 Git 地 址 


点 击 右边 的 复制 按钮 可 以 将 版 本 库 的 Git 地 址 复制 到 剪贴 板 ，SunnyWeather 版 本 库 的 Git 地 址 
是 https://github.com/guolindev/SunnyWeather.git。 


然后 打开 终端 界面 并 切换 到 SunnyWeather 的 工程 目录 下 ， 如 图 15.13 所 示 。 


guolindeMacBook-Pro:~ guolin$ cd AndroidStudioProjects/AndroidFirstLine/SunnyWeather/ 


guolindeMacBook-Pro: SunnyWeather guolin$ 
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图 15.13 在 终端 中 进入 SunnyWeather 工 程 目 录 
接着 输入 git clone https://github.com/guolindev/SunnyWeather.git 把 远程 版 本 库 克 隆 到 | 


本 地 ， 如 图 15.14 所 示 。 


guolindeMacBook-Pro: SunnyWeather guolin$ git clone https://github.com/guolindev/SunnyWeather .git 
Cloning into 'SunnyWeather'... 
remote: Enumerating objects: 5, done. 


remote: Counting objects: 100% (5/5), done. 
remote: Compressing objects: 100% (4/4)，done， 
remote: Totalt 5 (delta 0)，reused 0 (delta 0)，pack-reused 0 


Unpacking objects: 100% (5/5), done. 


guolindeMacBook-Pro:SunnyWeather guolin$ 


15.14 ”将 远程 版 本 库 克隆 到 本 地 


看 到 图 中 的 文字 提示 就 表示 克隆 成 功 了 ， 并 且 .gitignore、LICENSE 和 README.md 这 3 个 文件 
也 已 经 被 复制 到 了 本 地 ， 可 以 进入 SunnyWeather 目 录 ， 并 使 用 Ls -al 命 令 查看 一 下 ， 如 图 


15.15 所 示 。 


guolindeMacBook-Pro: SunnyWeather guolin$ cd SunnyWeather 
guolindeMacBook-Pro: SunnyWeather guolin$ 1s -al 


total 40 

drwxr-xr-x 6 guolin 
drwxr-xr-x 15 guolin 
drwxr-xr-x 12 guolin 
-rw-r--r-- 1 guolin 
-rw-r--r-- 1 guolin 
-rw-r--r-- 1 guolin 


staff 
staff 
staff 
staff 
staff 
staff 


192 10 14 22:06 . 


480 10 14 22:06 . 


384 10 14 22:06 
1002 10 14 22:06 
11357 10 14 22:06 
14 10 14 22:06 


guolindeMacBook-Pro: SunnyWeather guolin$ 


图 15.15 查看 克隆 到 本 地 的 文件 


.git 
.gitignore 
LICENSE 
README .md 


现在 我 们 需要 将 这 个 目录 中 的 文件 全 部 复制 粘贴 到 .上 一 层 目录 中 ， 这 样 就 能 将 整个 
SunnyWeather 工 程 目录 添加 到 版 本 控制 中 去 了 。 注 意 ，.git 是 一 个 隐藏 目录 ， 在 复制 的 时 候 
二 万 不 要 漏 掉 。 另 外 ， 上 一 层 目录 中 也 有 一 个 .gitignore 文 件 ， 我 们 直接 将 其 覆盖 即 可 。 复 制 完 
之 后 可 以 将 该 SunnyWeather 目 录 删 除 ,最终 SunnyWeather 工 程 的 目录 结构 应 该 如 图 15.16 


所 不 。 
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guolindeMacBook-Pro: SunnyWeather guolin$ 1s -al 

total 104 

drwxr-xr-x 17 guolin staff 544 10 14 22:15 . 

drwxr-xr-x 34 guolin staff 1088 10 14 21:57 .. 

drwxr-xr-x 12 guolin staff 384 10 14 22:06 .git 

-rwW-r--r-- guolin staff 1002 10 14 22:06 .gitignore 
drwxr-xr-x guolin staff 160 10 14 21:57 .gradle 
drwxr-xr-x guolin staff 320 10 14 21:57 .idea 

-rw-r--r-- guolin staff 11357 10 14 22:06 LICENSE 

guolin staff 14 10 14 22:06 README .md 

guolin staff 831 10 14 21:57 SunnyWeather .iml 
guolin staff 256 10 14 21:57 app 

guolin staff 661 10 14 21:57 build.gradle 
guolin staff 96 10 14 21:57 gradle 

guolin staff 1169 10 14 21:57 gradle.properties 
guolin staff 5296 10 14 21:57 gradlew 
-rwW-r--r-- guolin staff 2260 10 14 21:57 gradlew.bat 
-rw-r--r-- guolin staff 436 10 14 21:57 local .properties 
-rw-r--r-- 1 guolin staff 47 10 14 21:57 settings.gradle 
guolindeMacBook-Pro: SunnyWeather guolin$ 


Ha 


-rw-r--r-- 


-PW-r--Pr-- 
drwxr-xr-x 
-rwW-r--r-- 
drwxr-xr-x 
-rw-r--r-- 
-rwWxXr--r-- 


PppPpPPWPoOPPPOU 


图 15.16 SunnyWeather 工 程 的 目录 结构 


接 下 来 ， 我 们 应 该 把 SunnyWeather 项 目 中 现 有 的 文件 提交 到 GitHub 上 面 。 这 就 很 简单 了 ， 先 
将 所 有 文件 添加 到 版 本 控制 中 ， 如 下 所 示 : 


然后 在 本 地 执行 提交 操作 : 


git commit -m "First commit." 


最 后 将 提交 的 内 容 同步 到 远程 版 本 库 ， 也 就 是 GitHub 上 面 : 


git push origin master 


注意 ， 在 最 后 一 步 的 时 候 ，GitHub 可 能 会 要 求 输入 用 户 名 和 密码 来 进行 身份 校 输 。 这 里 输入 我 
们 注册 时 填 入 的 用 户 名 和 密码 就 可 以 了 ， 最 终结 果 如 图 15.17 所 示 。 


guolindeMacBook-Pro:SunnyWeather guolin$ git push origin master 
Counting objects: 70, done. 

Delta compression using up to 4 threads. 

Compressing objects: 100% (52/52),，done. 

Writing objects: 100% (70/70), 126.23 KiB | 9.02 MiB/s, done. 


Total 70 (delta 0), reused 0 (delta 0) 

To https://github.com/guolindev/SunnyWeather .git 
00cf416. .2d871ee master -> master 

guolindeMacBook-Pro: SunnyWeather guolin$ 


图 15.17 将 提交 的 内 容 同步 到 远程 版 本 库 


这 样 就 已 经 同步 完成 了 ， 现 在 刷新 一 下 SunnyWeather 版 本 库 的 主页 ， 你 会 看 到 刚才 提交 的 那 
些 文件 已 经 存在 了 ,如 图 15.18 所 示 。 
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Tony First commit. 


mn .idea First commit. 
a app First commit. 
a gradle/wrapper First commit. 
四 .gitignore Initial commit 
国 LICENSE Initial commit 
国 README.md Initial commit 
国 build.gradle First commit. 
国 gradle.properties First commit. 
司 gradlew First commit. 
国 gradlew.bat First commit. 
国 settings.gradle First commit. 


图 15.18 在 GitHub. 上 查看 提交 的 内 容 
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Latest commit 2d871ee 4 minutes ago 


4 minutes ago 
4 minutes ago 
4 minutes ago 
38 minutes ago 
38 minutes ago 
38 minutes ago 
4 minutes ago 
4 minutes ago 
4 minutes ago 
4 minutes ago 


4 minutes ago 


15.3 搭建 MVVM 项 目 架构 


你 应 该 还 记得 ， 在 第 13 章 中 我 们 重点 学 习 了 jetpack 的 架构 组 件 ， 当 时 就 提 到 过 ,jetpack 中 的 
许多 架构 组 件 是 专门 为 了 MVVM 架 构 而 量 身 打 造 的。 那么 到 底 什么 是 MVVM 架 构 ? 又 该 如 何 搭 
建 一 个 MVVM 架 构 的 项 目 呢 ? 本 节 我 们 就 来 学 习 一 下 这 方面 的 知识 。 


MVVM (Model-View-ViewModel) 是 一 种 高 级 项 目 架构 模式 ， 目 前 已 被 广泛 应 用 在 Android 
程序 设计 领域 ， 类似 的 架构 模式 还 有 MVP、MVC 等 。 简 单 来 讲 ，MVVM 架 构 可 以 将 程序 结构 主 
要 分 成 3 部 分 : Model 是 数据 模型 部 分 ; View 是 界面 展示 部 分 ; 而 ViewModel 比 较 特殊 ， 可 以 
将 它 理 解 成 一 个 连接 数据 模型 和 界面 展示 的 桥梁 ,从 而 实现 让 业务 逻辑 和 界面 展示 分 离 的 程序 
结构 设计 。 


当然 ， 一 个 优秀 的 项 目 架构 除了 会 包含 以 上 3 部 分 内 容 之 外 ， 还 应 该 包含 仓库 、 数 据 源 等 ， 这 里 
我 画 了 一 幅 非 常 简单 易 懂 的 MVVM 项 目 架 构 示 意图 ,如 图 15.19 所 示 。 


UI 控制 层 


本 地 数据 源 


图 15.19 MVVM 项 目 架 构 示 意图 


可 以 看 到 ， 我 们 通过 这 张 架构 示意 图 将 程序 分 为 了 若干 层 。 其 中 ，UI 控 制 层 包含 了 我 们 平时 写 
的 Activity、Fragment、 布 局 文件 等 与 界面 相关 的 东西 。ViewModel 层 用 于 持 有 和 UI 元 素 相关 
的 数据 ， 以 保证 这 些 数据 在 屏幕 旋转 时 不 会 丢失 ， 并 且 还 要 提供 接口 给 Ul 控 制 层 调用 以 及 和 仓 
库 层 进行 通信 。 仓 库 层 要 做 的 主要 工作 是 判断 调用 方 请 求 的 数据 应 该 是 从 本 地 数据 源 中 获取 还 
是 从 网 络 数据 源 中 获取 ， 并 将 获取 到 的 数据 返回 给 调用 方 。 本 地 数据 源 可 以 使 用 数据 库 、 
SharedPreferences 等 持久 化 技术 来 实现 ， 而 网 络 数据 源 则 通常 使 用 Retrofit 访 问 服务 妖 提 供 
的 Webservice 接 口 来 实现 。 
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另外 ， 对 于 这 张 架构 示意 图 ,我 还 有 必要 再 解释 一 下 。 图 中 所 有 的 箭头 都 是 单 向 的 ， 比 方 说 UI 
控制 层 指向 了 ViewModel 层 ， 表 示 UI 控 制 层 会 持 有 ViewModel 层 的 引用 ， 但 是 反 过 来 

ViewModel 层 却 不 能 持 有 UI 控制 层 的 引用 ， 其 他 几 层 也 是 一 样 的 道理 。 除 此 之 外 ， 引 用 也 不 能 
跨 层 持 有 ， 比 如 UI 控制 层 不 能 持 有 仓库 层 的 引用 ， 谨 记 每 一 层 的 组 件 都 只 能 与 它 相 邻 层 的 组 件 


进行 交互 。 


那么 接 下 来 ， 我 们 会 严格 按照 刚才 的 架构 示意 图 对 SunnyWeather 这 个 项 目 进行 实现 。 为 了 让 
项 目 能 够 有 更 好 的 结构 ， 这 里 需要 在 com.sunnyweather.android 包 下 再 新 建 几 个 包 ，, 如 图 
15.20 所 示 。 


java 
com.sunnyweather.android 
logic 
dao 
model 
network 
ui 
place 
weather 
EMainActivity 


图 15.20 ”项 目的 新 结构 


很 明显 ，logic 包 用 于 存放 业务 逻辑 相关 的 代码 ，ui 包 用 于 存放 界面 展示 相关 的 代码 。 其 中 ， 
logic 包 中 又 包含 了 dao、model、network 这 3 个 子 包 ， 分别 用 于 存放 数据 访问 对 象 、 对 象 模 
型 以 及 网 络 相关 的 代码 。 而 ui 包 中 又 包含 了 place 和 weather 这 两 个 子 包 ， 分别 对 应 
SunnyWeather 中 的 两 个 主要 界面 。 


另外 ， 在 整个 项 目的 开发 过 程 中 ， 我们 还 会 用 到 许多 依赖 库 ， 为 了 方便 后 面 的 代码 编写 ， 这 里 
就 提前 把 所 有 会 用 到 的 依赖 库 都 声明 一 下 吧 。 编 辑 app/build.gradle 文 件 ， 在 dependencies 
闭 包 中 添加 如 下 内 容 : 


dependencies { 


implementation 'androidx.recyclerview:recyclerview:1.0.0' 
implementation "androidx.lifecycle:lifecycle-extensions:2.2.0" 
implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.2.0" 
implementation 'com.google.android.material:material:1.1.0' 
implementation?"androidx.swiperefreshlayout:swiperefreshlayout:1.0.0" 
implementation 'com.squareup.retrofit2:retrofit:2.6.1' 

implementation 'com.squareup.retrofit2:converter-gson:2.6.1' 
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.3.0" 
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.1.1" 


} 


这 几 个 库 全 部 都 是 我 们 在 前 面 的 章节 中 使 用 过 的 ， 相 信 对 你 来 说 应 该 不 难 理解 。 


由 于 我 们 引入 了 Material 库 ， 所 以 一 定 要 记得 将 AppTheme 的 parent 主 题 改 成 
MaterialComponents 模 式 ， 也 就 是 将 原来 的 AppCompat 部 分 改 成 MaterialComponents 即 
可 。 
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另外 , 为 了 让 SunnyWeather 的 界面 更 加 美观 ， 这 里 我 提前 准备 了 许多 张 后 续 开 发 时 会 用 到 的 


图 片 ， 并 把 它们 都 放 到 了 drawable-xxhdpi 目 录 下 (图片 下 载 方式 见 前 言 ) 


不 。 


图 15.21 事先 准备 好 的 图 片 资 源 


, 如 图 15.21 所 


drawable-xxhdpi 
3 bg_clear_day.jpg 


bg_clear_night.jpg 


3 bg_cloudy.jpg 

3 bg_ fog.jpg 

3 bg_partly_cloudy_day.jpg 
3 bg_partly_cloudy_night.jpg 
3 bg_place.png 

3 bg_rain.jpg 

3 bg_snow.jpg 

3 bg_wind.jpg 
ic_carwashing.png 


3 ic_clear_day.png 


3 ic_clear_night.png 
3 ic_cloudy.png 

3 ic_coldrisk.png 

3 ic_dressing.png 

3 ic fog.png 

3 ic_hail.png 

3 ic_heavy_haze.png 
3 ic_heavy_rain.png 
3 ic_heavy_snow.png 


ic home.png 


3 ic_light_haze.png 
3 ic_light_rain.png 


ic_light_snow.png 
ic moderate_haze.png 
ic moderate_rain.png 


3 ic moderate_snow.png 


ic_partly_cloud_day.png 


3 ic_partly_cloud_night.png 
3 ic_sleet.png 
ic_storm_rain.png 


四 


ic_thunder_shower.png 


3 ic_ultraviolet.png 
3 search_bg.9.png 


将 这 些 准备 工作 都 做 好 了 之 后 ， 接 下 来 就 正式 进入 SunnyWeather 项 目的 开发 当中 吧 。 
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15.4 ”搜索 全 球 城市 数据 


根据 之 前 的 技术 可 行 性 分 析 ， 要 想 实 现 查 看 天 气 信 息 的 功能 ,首先 要 能 搜索 到 具体 的 城市 数 
据 ,并 获取 该 地 区 的 经 纬度 坐标 。 因 此 ,我们 第 一 阶段 的 开发 任务 就 是 先 来 实现 搜索 全 球 城市 
的 数据 信息 。 根 据 合理 的 开发 方式 ， 实 现 过 程 应 该 主要 分 为 逻辑 层 实现 和 UI 层 实 现 两 部 分 ， 那 
么 我 们 先 从 逻辑 层 实现 开始 吧 。 


15.4.1 实现 逻辑 层 代码 


使 用 MVVM 这 种 分 层 架 构 的 设计 , 由 于 从 ViewModel 层 开始 就 不 再 持 有 Activity 的 引用 了 ， 
此 经 常会 出 现 “ 缺 Context" 的 情况 。 所 以 我 们 可 以 先 使 用 第 14 章 中 学 到 的 技术 ,给 
SunnyWeather 项 目 提 供 一 种 全 局 获取 Context 的 方式 。 


在 com.sunnyweatherandroid 包 下 新 建 一 个 SunnyWeatherAppLication 类 ， 代 码 如 下 所 


小 : 


class SunnyWeatherApplication : AppLication() { 


companion object { 
@SuppressLint("StaticFieldLeak") 
lateinit var context: Context 


} 


override fun onCreate() { 
Super.onCreate() 
context = applicationContext 


} 
} 


这 段 代 码 我 们 刚刚 在 上 一 章 中 学 习 过 ， 你 应 该 记忆 犹 新 吧 。 然 后 还 需要 在 
AndroidManifest.xml 文 件 的 <appLication> 标 签 下 指定 SunnyWeatherAppLication ， 
如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.sunnyweather.android"> 
<application 
android:name=" .SunnyWeatherApplication" 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
android:roundIcon="@mipmap/ic launcher round" 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 
</manifest> 


经 过 这 样 的 配置 之 后 ， 我 们 就 可 以 在 项 目的 任何 位 置 通过 调用 
SunnyWeatherApplication.context 来 获取 Context 对 象 了 ， 非常 便利 。 
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另外 , 我 们 刚才 不 是 在 彩云 天 气 的 开发 者 平台 申请 到 了 一 个 令 牌 值 吗 ? 可 以 将 这 个 令 牌 值 也 配 
置 在 SunnyWeatherApplication 中 ,方便 之 后 的 获取 ， 如 下 所 示 : 
class SunnyWeatherApplication : Application() { 


companion object { 
const val TOKEN =" 填 入 你 申请 到 的 令 牌 值 " 


} 


完成 了 第 一 步 的 工作 之 后 ， 下面 我 们 就 可 以 按照 图 15.19 所 示 的 架构 示意 图 ， 自 底 向 上 一 步 步 进 
行 实现 。 首 先 来 定义 一 下 数据 模型 , 在 logic/model 包 下 新 建 一 个 PlaceResponse.kt 文 件 ， 并 
在 这 个 文件 中 编写 如 下 代码 : 


data class PlaceResponsel(val status: String, val places: List<Place>) 


data class Place(val name: String, val location: Location, 
@SerializedName("formatted address") val address: String) 


data class Location(val lng: String, val lat: String) 


很 简单 ，PlaceResponse.kt 文 件 中 定义 的 类 与 属性 ， 完 全 就 是 按照 15.1 节 中 搜索 城市 数据 接 
口 返 回 的 JSON 格 式 来 定义 的 。 不 过 ， 由 于 JSON 中 一 些 字段 的 命名 可 能 与 Kotlin 的 命名 规范 不 太 
一 致 ,因此 这 里 使 用 了 @SerializedName 注 解 的 方式 ,来 让 JSON 字 段 和 Kotlin 字 上 段 之 间 建 立 
映射 关系 。 


定义 好 了 数据 模型 ， 接 下 来 我 们 就 可 以 开始 编写 网 络 层 相 关 的 代码 了 。 首 先 定 义 一 个 用 于 访问 
彩云 天 气 城 市 搜索 API 的 Ret rofit 接 口 ， 在 logic/network 包 下 新 建 PLaceService 接 口 ， 代 
码 如 下 所 示 : 


interface PlaceService { 


@GET("v2/place?token=${SunnyWeatherApplication.TOKEN}&LlLang=zh CN") 


fun searchPlaces(@Query("query") query: String): Call<PlaceResponse> 


可 以 看 到 ,我们 在 searchPlaces ( ) 方 法 的 上 面 声明 了 一 个 GGET 注 解 ， 这 样 当 调 用 
searchPLaces ( ) 方 法 的 时 候 ，Retrofit 就 会 自动 发 起 一 条 GET 请 求 ， 去 访问 QGET 注 解 中 本 
置 的 地 址 。 其 中 ， 搜 索 城 市 数据 的 APl 中 只 有 que ry 这 个 参数 是 需要 动态 指定 的 ， 我 们 使 用 
G@Que ry 注 解 的 方式 来 进行 实现 ， 另 外 两 个 参数 是 不 会 变 的 ， 因 此 固定 写 在 GGET 注 解 中 即 可 。 


另外 , searchPLaces () 方 法 的 返回 值 被 声明 成 了 CaLL<PLaceResponse> ,这样 Ret rofit 
就 会 将 服务 闫 返回 的 JSON 数 据 自 动 解析 成 PLaceResponse 对 象 了 。 


定义 好 了 PlaceService 接 口 ,为 了 能 够 使 用 它 ， 我 们 还 得 创建 一 个 Retrofit 构 建 右 才 行 。 
在 logic/network 包 下 新 建 一 个 ServiceCreator 单 例 类 ， 代码 如 下 所 示 : 


object ServiceCreator { 


private const val BASE URL = "https://api.caiyunapp.com/" 
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private val retrofit = Retrofit.BuiLder() 


.baseUrl (BASE URL) 
.addConverterFactory(GsonConverterFactory.create()) 


.build() 


fun <T> create(serviceClass: Class<T>): T = retrofit.create(serviceClass) 


inline fun <reified T> create(): T = create(T::class.java) 


} 
这 个 Ret rofit 构 建 普 完 全 是 按照 我 们 在 11.6.3 小 节 中 学 习 的 方式 来 编写 的 ， 因 此 对 于 你 

说 ， 理解 起 来 应 该 没有 任何 问题 。 

统一 的 网 络 数据 源 访问 入 口 ， 对 所 有 网 络 请 求 的 AP 进行 封装 。 同 


样 在 logic/network 包 下 新 建 一 个 SunnyWeatherNetwork 单 例 类 ， 代 码 如 下 所 示 : 


object SunnyWeatherNetwork { 


private val placeService = ServiceCreator.create<PlaceService>() 


suspend fun searchPLaces(query: String) = placeService.searchPlaces(query).await() 


private suspend fun <T> Call<T>.await(): T{ 
return suspendCoroutine { continuation -> 
enqueue(object : Callback<T> { 

override fun onResponse(call: Call<T>, 

val body = response.body() 

if (body != null) continuation.resume(body) 

else continuation.resumeWithException( 

RuntimeException("response body is null")) 


response: Response<T>) { 


} 


override fun onFailure(call: Call<T>, t: Throwable) { 
continuation.resumeWithException(t) 


这 是 一 个 非常 关键 的 类 ， 并且 用 到 了 许多 高 级 技巧 ， 我 来 带 你 慢 慢 解析 一 下 。 

首先 我 们 使 用 ServiceCreator 创 建 了 一 个 PlaceService 接 口 的 动态 代理 对 象 ， 然 后 定义 了 
一 个 searchPlaces ( ) 哨 数 ， 并 在 这 里 调用 刚刚 在 PlaceService 接 口中 定义 的 
searchPLaces () 方 法 ,以 发 起 搜索 城市 数据 请 求 。 

但 是 为 了 让 代码 变 得 更 加 简洁 ， 我 们 使 用 了 11.7.3 小 节 中 学 习 的 技巧 来 简化 Ret rofit 回 调 的 
写法 。 由 于 是 需要 借助 协 程 技术 来 实现 的 ， 因 此 这 里 又 定义 了 一 个 await ( ) 函 数 , 并 将 
searchPLaces ( ) 国 数 也 声明 成 挂 起 函数 。 至 于 await ( ) 函数 的 实现 ， 之 前 在 11.7.3 小 节 就 解 
析 过 了 ， 所 以 应 该 是 很 好 理解 的 。 


这 样 ， 当 外 部 调用 SunnywWeatherNetwork 的 searchPlaces ( ) 函 数 时 ，Ret rofit 就 会 立即 
发 起 网 络 请 求 ， 同 时 当前 的 协 程 也 会 被 阻塞 住 。 直 到 服务 器 响应 我 们 的 请 求 之 后 ，await( ) 函 
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数 会 将 解析 出 来 的 数据 模型 对 象 取出 并 返回 ,同时 恢复 当前 协 程 的 执行 ，searchPlaces() 淫 
数 在 得 到 await ( ) 喇 数 的 返回 值 后 会 将 该 数据 再 返回 到 上 一 层 。 


这 样 网 络 层 相 关 的 代码 我 们 就 编写 完了 ， 下 面 开始 编写 仓库 层 的 代码 。 之 前 已 经 解释 过 ， 仓 库 
层 的 主要 工作 就 是 判断 调用 方 请 求 的 数据 应 该 是 从 本 地 数据 源 中 获取 还 是 从 网 络 数据 源 中 获 
取 ， 并 将 获得 的 数据 返回 给 调用 方 。 因 此 ， 仓 库 层 有 点 像 是 一 个 数据 获取 与 缓存 的 中 间 层 ,在 
本 地 没有 缓存 数据 的 情况 下 就 去 网 络 层 获取 ， 如 果 本 地 已 经 有 缓存 了 ， 就 直接 将 缓存 数据 返 
回 。 


不 过 我 个 人 认为 ， 这 种 搜索 城市 数据 的 请 求 并 没有 太 多 缓存 的 必要 ,每 次 都 发 起 网 络 请 求 去 获 
取 最 新 的 数据 即 可 ， 因 此 这 里 就 不 进行 本 地 缓存 的 实现 了 。 在 logic 包 下 新 建 一 个 Repository 
单 例 类 ， 作 为 仓库 层 的 统一 封装 入 口 ， 代 码 如 下 所 示 : 


object Repository { 


fun searchPLaces(query: String) = liveData(Dispatchers.10) { 
val result = try { 

val placeResponse = SunnyWeatherNetwork.searchPlaces (query) 

if (placeResponse.status == "ok") { 
val places = placeResponse.places 
Result.success(places) 

} else{ 
Result.failure(RuntimeException("response status is 

${placeResponse.status}")) 


} 
} catch (e: Exception) { 
Result.failure<List<Place>>(e) 
} 


emit(result) 


} 


一 般 在 仓库 层 中 定义 的 方法 ,为 了 能 将 异步 获取 的 数据 以 响应 式 编程 的 方式 通知 给 上 一 层 ， 通 
常会 返回 一 个 LiveData 对 象 。 我 们 在 13.4 节 已 经 学 过 了 LiveData 最 常用 的 一 些 用 法 ,不 过 这 
里 又 使 用 了 一 个 新 的 技巧 。 上 述 代码 中 的 LiveData( ) 函 数 是 lifecycle-livedata-ktx 库 提供 的 
一 个 非常 强大 且 好 用 的 功能 ， 它 可 以 自动 构建 并 返回 一 个 LiveData 对 象 ， 然 后 在 它 的 代码 块 中 
提供 一 个 挂 起 函数 的 上 下 文 ， 这 样 我 们 就 可 以 在 LiveData( ) 函数 的 代码 块 中 调用 任意 的 挂 起 
函数 了 。 这 里 调用 了 SunnyWeatherNetwork 的 searchPLaces ( ) 函 数 来 搜索 城市 数据 ， 然 后 
判断 如 果 服 务 部 响应 的 状态 是 ok， 那 么 就 使 用 Kotlin 内 置 的 ResuLt .Success ( ) 方 法 来 包装 获 
取 的 城市 数据 列表 ， 否则 使 用 Result.failure() 方 法 来 包装 一 个 异常 信息 。 最 后 使 用 一 个 
emit () 方 法 将 包装 的 结果 发 射出 去 , 这 个 emit ( ) 方 法 其 实 类 似 于 调用 LiveData 的 
setValue( ) 方 法 来 通知 数据 变化 ， 只 不 过 这 里 我 们 无 法 直接 取得 返回 的 LiveData 对 象 ， 所 以 
lifecycle-livedata-ktx 库 提供 了 这 样 一 个 替代 方法 。 


另外 需要 注意 ， 上述 代 码 中 我 们 还 将 LiveData ( ) 函数 的 线程 参数 类 型 指定 成 了 
Dispatchers,I0 , 这样 代 码 块 中 的 所 有 代码 就 都 运行 在 子 线程 中 了 。 众 所 周知 , Android 是 
不 允许 在 主线 程 中 进行 网 络 请 求 的 ， 诸 如 读 写 数据 库 之 类 的 本 地 数据 操作 也 是 不 建议 在 主线 程 
中 进行 的 ， 因 此 非常 有 必要 在 仓库 层 进行 一 次 线程 转换 。 
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写 到 这 里 ， 逻 辑 层 的 实现 就 只 剩 最 后 一 步 了 : 定义 ViewModel 层 。ViewModel 相 当 于 逻辑 层 和 
UI 层 之 间 的 一 个 桥 粱 ， 虽 然 它 更 偏向 于 逻辑 层 的 部 分 ， 但 是 由 于 ViewModel 通 常 和 Activity 或 
Fragment 是 一 一 对 应 的 ， 因 此 我 们 还 是 习惯 将 它们 放 在 一 起 。 


在 ui/place 包 下 新 建 一 个 PlaceViewModel , 代码 如 下 所 示 : 


class PlaceViewModel : ViewModel() { 
private val searchLiveData = MutableLiveData<String>() 
val placeList = ArrayList<Place>() 
val placeLiveData = Transformations.switchMap(searchLiveData) { query -> 


Repository.searchPlaces (query) 


fun SearchPLaces(query: String) { 
searchLiveData.value = query 


} 


ViewModel 层 的 代码 就 相对 比较 简单 了 。 首 先 PlaceViewModel 中 也 定义 了 一 个 
searchPLaces ( ) 方 法 ， 但 是 这 里 并 没有 直接 调用 仓库 层 中 的 searchPLaces ( ) 方 法 ,而 是 将 
传 入 的 搜索 参数 赋值 给 了 一 个 searchLiveData 对 象 ， 并 使 用 Transformations 的 
switchMap ( ) 方 法 来 观察 这 个 对 象 ， 人 否则 仓库 层 返回 的 LiveData 对 象 将 无 法 进行 观察 。 关 于 
这 一 点 ， 我们 已 经 在 13.4.2 小 节 讨论 过 了 。 现 在 每 当 searchPlaces( ) 项 数 被 调用 时 ， 
SwitchMap ( ) 方 法 所 对 应 的 转换 函数 就 会 执行 。 然 后 在 转换 函数 中 ， 我们 只 需要 调用 仓库 层 中 
定义 的 searchPLaces ( ) 方 法 就 可 以 发 起 网 络 请 求 ， 同 时 将 仓库 层 返回 的 LiveData 对 象 转换 成 
一 个 可 供 Activity 观 察 的 LiveData 对 象 。 


另外 ， 我 们 还 在 PlaceViewModel 中 定义 了 一 个 pLaceList 集 合 ， 用 于 对 界面 上 显示 的 城市 数 
据 进行 缓存 ， 因 为 原则 上 与 界面 相关 的 数据 都 应 该 放 到 ViewModel 中 ， 这 样 可 以 保证 它们 在 手 
机 屏幕 发 生 旋 转 的 时 候 不 会 丢失 ， 稍 后 我 们 会 在 编写 UI 层 代码 的 时 候 用 到 这 个 集合 。 


好 了 ， 关 于 逻辑 层 的 实现 到 这 里 就 基本 完成 了 ,现在 SunnyWeather 项 目 已 经 拥有 了 搜索 全 球 
城市 数据 的 能 力 ， 那 么 接 下 来 就 开始 进行 UI 层 的 实现 吧 。 


15.4.2 ”实现 UI 层 代 码 


UI 层 的 实现 一 般 是 从 编写 布局 文件 开始 的 ， 由 于 搜索 城市 数据 的 功能 我 们 在 后 面 还 会 复 用 ， 因 
此 就 不 建议 写 在 Activity 里 面 了 ， 而 是 应 该 写 在 Fragment 里 面 ， 这 样 当 需 要 复 用 的 时 候 直接 在 
布局 里 面 引 入 该 Fragment 即 可 。 


在 res/layout 目 录 中 新 建 fragment_place.xml 布 局 ， 代码 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="?android:windowBackground"> 


<ImageView 
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android:id="@+id/bgImageView" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout alignParentBottom="true" 
android:src="@drawable/bg place"/> 


<FrameLayout 
android:id="@+id/actionBarLayout" 
android:layout width="match parent" 
android:layout height="60dp" 
android:background="@color/colorPrimary"> 


<EditText 

android:id="@+id/searchPlaceEdit" 
android:layout width="match parent" 
android:layout height="40dp" 
android:layout gravity="center vertical" 
android:layout marginStart="10dp" 
android:layout marginEnd="10dp" 
android:paddingStart="10dp" 
android:paddingEnd="10dp" 
android:hint=" 输 入 地 址 " 
android:background="@drawable/search bg"/> 

</FrameLayout> 


<androidx.recyclerview.widget.RecyclerView 
android:id="@+id/recyclerView" 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout below="@id/actionBarLayout" 
android:visibility="gone"/> 


</RelativeLayout> 


这 个 布局 中 主要 有 两 部 分 内 容 : EditText 用 于 给 用 户 提供 一 个 搜索 框 ， 这样 用 户 就 可 以 在 这 里 
搜索 任意 城市 ; RecyclerView 则 主要 用 于 对 搜索 出 来 的 结果 进行 展示 。 另 外 这 个 布局 中 还 有 一 
个 ImageView 控 件 ， 它 的 作用 只 是 为 了 显示 一 张 背景 图 ， 从 而 让 界面 变 得 更 加 美观 ， 和 主体 功 
能 无 关 。 


另外 ， 简 单 起 见 ， 所 有 布局 中 显示 的 文字 我 都 会 使 用 硬 编码 的 写法 。 这 当然 不 是 一 种 良好 的 习 
惯 ， 你 在 实现 的 时 候 应 该 将 这 些 文字 都 定义 到 strings.xml 中 ， 然 后 在 布局 中 进行 引用 。 


既然 用 到 了 RecyclerView，, 那么 毫 无 疑问 ， 我 们 还 得 定义 它 的 子 项 布局 才 行 。 在 layout 目 录 下 
新 建 一 个 place_item.xmI 文 件 ， 代码 如 下 所 示 : 


<com.google.android.material.card.MaterialCardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="130dp" 
android:Layout margin="12dp" 
app:cardCornerRadius="4dp"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="18dp" 
android:layout gravity="center vertical"> 
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<TextView 
android:id="@+id/placeName" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:textColor="?android:attr/textColorPrimary" 
android:textSize="20sp"/> 


<TextView 
android:id="@+id/placeAddress" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginTop="10dp" 
android:textColor="?android:attr/textColorSecondary" 
android:textSize="14sp"/> 


</LinearLayout> 


</com.google.android.material.card.MaterialCardView> 


这 里 使 用 了 MaterialCardView 来 作为 子 项 的 最 外 层 布 局 ， 从 而 使 得 RecyclerView 中 的 每 个 元 
素 都 是 在 卡片 中 的 。 至 于 卡片 中 的 元 素 内 容 非常 简单 ， 只 用 到 了 两 个 TextView， 一 个 用 于 显示 
搜索 到 的 地 区 名 ， 一 个 用 于 显示 该 地 区 的 详细 地 址 。 


将 子 项 布局 也 定义 好 了 之 后 ， 接 下 来 就 需要 为 RecyclerView 准 备 适 配器 了 。 在 ui/place 包 下 新 
建 一 个 PLaceAdapter 类 ， 让 这 个 适配器 继承 自 RecycLerView.Adapter, 并 将 泛 型 指定 为 
PlaceAdapter.ViewHolder , 代码 如 下 所 示 : 


class PLaceAdapter(private val fragment: Fragment，private val pLaceList: List<Place>) 
RecyclerView.Adapter<PlaceAdapter.ViewHolder>() { 


inner class ViewHolder(view: View) : RecyclerView.ViewHolder(view) { 
val placeName: TextView = view.findViewById(R.id.placeName) 
val placeAddress: TextView = view.findViewById(R.id.placeAddress) 


} 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context).inflate(R.Tlayout.place item, 
parent, false) 
return ViewHolder (view) 


} 


override fun onBindViewHolder(holder: ViewHolder, position: Int) { 
val place = placeList[position] 
holder.placeName.text = place.name 
holder.placeAddress .text = place.address 


} 


override fun getItemCount() = placeList.size 


这 里 使 用 的 都 是 RecyclerView 适 配器 的 标准 写法 ， 之 前 我 们 已 经 实现 过 好 几 遍 了 ， 相 信 没 有 什 
么 需要 解释 的 地 方 。 


现在 适 配 居 也 准备 好 了 “， 只 剩 下 对 Fragment 进 行 实现 了 。 在 ui/place 包 下 新 建 一 个 
PlaceFragment ,并 让 它 继承 自 AndroidX 库 中 的 Fragment ,代码 如 下 所 示 : 
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class PlaceFragment : Fragment() { 
val viewModel by lazy { ViewModelProvider(this).get(PlaceViewModel::class.java) } 
private lateinit var adapter: PlaceAdapter 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
return inflater.inflate(R.layout.fragment place, container, false) 


} 


override fun onActivityCreated(savedInstanceState: Bundle?) { 
super.onActivityCreated(savedInstanceState) 
val layoutManager = LinearLayoutManager(activity) 
recyclerView.layoutManager = layoutManager 
adapter = PlaceAdapter(this, viewModel .placeList) 
recyclerView.adapter = adapter 
searchPlaceEdit.addTextChangedListener { editable -> 
val content = editable.toString() 
if (content.isNotEmpty()) { 
viewModel .searchPlaces (content) 
} else { 
recyclerView.visibility = View.GONE 
bgImageView.visibility = View.VISIBLE 
viewModel .placelList.clear() 
adapter.notifyData9etChanged () 
} 
} 
viewModel .placeLiveData.observe(this, Observer{ result -> 
val places = result.getOrNull() 
if (places != null) { 
recyclerView.visibility = View.VISIBLE 
bgImageView.visibility = View.GONE 
viewModel .placelList.clear() 
viewModel.placeList.addAll (places) 
adapter.notifyData9etChanged () 
} elLse { 
Toast .makeText(activity，" 未 能 查询 到 任何 地 点 "，Toast .LENGTH SHORT) .show() 
reSsutLt .exception0rNuLL()?.printStackTrace() 


} 


这 段 代码 并 不 难 理解 ， 使 用 的 大 多 是 我 们 之 前 学 过 的 知识 ， 我 们 来 慢 慢 梳理 一 下 。 


首先 , 这 里 使 用 了 Lazy 范 数 这 种 懒 加 载 技术 来 获取 PlaceViewModel 的 实例 , 这 是 一 种 非常 棒 
的 写法 ， 人 允许 我 们 在 整个 类 中 随时 使 用 viewModel 这 个 变量 ， 而 完全 不 用 关心 它 何 时 初始 化 、 


是 否 为 空 等 前 提 条 件 。 
接 下 来 在 onCreateView() 方 法 中 加 载 7 前 面 编写 的 fragment_place 布 局 , 这 是 Fragment 
的 标准 用 法 ， 没 什么 需要 解释 的 。 


最 后 再 来 看 onActivityCreated () 方 法 ,这 个 方法 中 先是 给 RecyclerView 设 置 了 
LayoutManager 和 适配器 ， 并 使 用 PlaceViewModel 中 的 pLaceList 集 合作 为 数据 源 。 紧 接 
着 调用 了 EditText 的 addTextChangedListener() 方 法 来 监听 搜索 框 内 容 的 变化 情况 。 每 当 
搜索 框 中 的 内 容 发 生 了 变化 ， 我 们 就 获取 新 的 内 容 ， 然 后 传递 给 PlaceViewModel 的 


www.blogss.cn 


searchPlaces() 方 法 ,这 样 就 可 以 发 起 搜索 城市 数据 的 网 络 请 求 了 。 而 当 输 入 搜索 框 中 的 内 
容 为 空 时 ， 我们 就 将 RecyclerView 隐 藏 起 来 ， 同时 将 那 张 仅 用 于 美观 用 途 的 背景 图 显示 出 来 。 


解决 了 搜索 城市 数据 请 求 的 发 起 ， 还 要 能 获取 到 服务 闫 响应 的 数据 才 行 ， 这 个 自然 就 需要 借助 
LiveData 来 完成 了 。 可 以 看 到 ， 这 里 我 们 对 PlaceViewModel 中 的 pLaceLiveData 对 象 进行 
观察 ， 当 有 任何 数据 变化 时 ， 就 会 回调 到 传 入 的 0bserver 接 口 实现 中 。 然 后 我 们 会 对 回调 的 数 
据 进行 判断 : 如 果 数 据 不 为 空 ， 那 么 就 将 这 些 数据 添加 到 PlaceViewModel 的 pLaceList 集 合 
中 ， 并 通知 PlaceAdapter 刷 新 界面 ; 如 果 数 据 为 空 ， 则 说 明 发 生 了 异常 ， 此 时 弹出 一 个 Toast 
提示 ， 并 将 具体 的 异常 原因 打印 出 来 。 


这 样 我 们 就 把 搜索 全 球 城市 数据 的 功能 完成 了 ， 可 是 Fragment 是 不 能 直接 显示 在 界面 上 的 ， 
此 我 们 还 需要 把 它 添加 到 Activity 里 才 行 。 修 改 activity_main.xml 中 的 代码 ， 如 下 所 示 : 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<fragment 
android:id="@+id/placeFragment" 
android:name="com.sunnyweather.android.ui.place.PlaceFragment" 
android:layout width="match parent" 
android:layout height="match parent" /> 


</FrameLayout> 


布局 文件 很 简单 ， 只 是 定义 了 一 个 FrameLayout , 然后 将 PlaceFragment 添 加 进来 ， 并 让 它 
充满 整个 布局 。 

另外 , 我 们 刚才 在 PlaceFragment 的 布局 里 面 已 经 定义 了 一 个 搜索 框 布局 ,因此 就 不 再 需要 原 
生 的 ActionBar 了 ， 修改 res/values/styles.xml 中 的 代码 ， 如 下 所 示 : 


<resources> 


<!-- Base application theme. --> 
<style name="AppTheme" parent="Theme.MaterialComponents.Light.NoActionBar"> 


</style> 


</resources> 


现在 第 一 阶段 的 开发 工作 基本 上 已 经 完成 了 ， 不 过 在 运行 程序 之 前 还 有 一 件 事 没有 做 ， 那 就 是 
声明 程序 所 需要 的 权限 。 修 改 AndroidManifest.xml 中 的 代码 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.sunnyweather.android"> 


<uses-permission android:name="android.permission.INTERNET" /> 


</manifest> 


由 于 我 们 是 通过 网 络 接口 来 搜索 城市 数据 的 ， 因 此 必须 添加 访问 网 络 的 权限 才 行 。 
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现在 可 以 运行 一 下 程序 了 ， 初 始 界面 如 图 15.22 所 示 。 


10:47 A 


号 办 是 


图 15.22 PlaceFragment 的 初始 界面 


接 下 来 我 们 可 以 在 搜索 框 里 随意 输入 全 球 任意 城市 的 名 字 ， 相 关 的 地 区 信息 就 出 现在 界面 上 
了 ， 如 图 15.23 所 示 。 
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北京 西 站 


北京 站 


图 15.23 与 北京 相关 的 地 区 信息 


虽然 现在 界面 上 只 显示 了 相关 地 区 的 名 称 与 地 址 ， 但 实际 上 每 个 地 区 所 对 应 的 经 纬度 信息 我 们 
也 已 经 获取 到 了 ， 这 为 接 下 来 的 天 气 预报 功能 开发 黄 定 了 基础 。 


你 可 能 会 问 ， 做 了 这 么 复杂 的 分 层 架构 设计 ， 好 处 到 搬 在 哪里 呢 ? 我 直接 将 代码 都 写 在 
Fragment 中 好 像 也 能 实现 同样 的 功能 。 没 错 ， 这 也 是 许多 初学 者 编写 Android 程 序 的 实现 方 
式 。 但 是 将 所 有 代码 都 写 在 Fragment 或 Activity 中 ， 会 让 类 变 得 非常 元 余 ， 等 项 目 越 来 越 复 杂 
之 后 ， 代 码 会 变 得 难以 阅读 和 维护 。 而 分 层 架 构 设 计 可 以 使 整个 项 目的 结构 十 分 清晰 ， 并 且 在 
现 有 架构 的 基础 上 扩展 其 他 功能 也 会 非常 方便 ， 待 会 进入 天 气 预 报 功能 开发 的 时 候 你 就 能 体会 
到 了 。 


好 了 ， 第 一 阶段 的 代码 与 到 这 里 就 差不多 了 “， 我 们 现在 提交 一 下 。 首 先 将 所 有 新 增 的 文件 添加 
到 版 本 控制 中 : 


git add . 
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接着 执行 提交 操作 : 


git commit -m “实现 搜索 全 球 城市 数据 功能 。" 


最 后 将 提交 同步 到 GitHub 上面 : 


git push origin master 


OK ! 第 一 阶段 完工 ， 下面 让 我 们 赶快 进入 第 二 阶段 的 开发 工作 中 吧 。 
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15.5 显示 天 气 信 息 


在 第 二 阶段 中 ， 我 们 就 要 开始 去 查询 和 天气， 并 且 把 天 气 信息 显示 出 来 了 。 实 现 的 过 程 也 是 类 似 
的 ， 同 样 主要 分 为 逻辑 层 实现 和 UI 层 实现 两 部 分 ,那么 我 们 仍然 先 从 逻辑 层 实现 开始 吧 。 


15.5.1 实现 逻辑 层 代 码 


由 于 彩云 天 气 返回 的 数据 内 容 非常 多 ， 这 里 我 们 不 可 能 将 所 有 的 内 容 都 利用 起 来 ， 因 此 我 第 选 
了 一 些 比较 重要 的 数据 来 进行 解析 与 展示 。 


首先 回顾 一 下 获取 实时 天 气 信息 接口 所 返回 的 SON 数 据 格式 ， 简 化 后 的 内 容 如 下 所 示 : 


"status": "ok", 
"result": { 
"realtime": { 
"temperature": 23.16, 
"skycon": "WIND", 
"air quality": { 
"aqi": { "chn":; 17.0 } 


. 
} 


} 


那么 我 们 只 需要 按照 这 种 JSON 格 式 来 定义 相应 的 数据 模型 即 可 。 在 logic/model 包 下 新 建 一 个 
RealtimeResponse.kt 文 件 , 并 在 这 个 文件 中 编写 如 下 代码 : 


data class RealtimeResponse(val status: String, val result: Result) { 
data class Result(val realtime: Realtime) 


data class Realtime(val skycon: String, val temperature: Float, 
@SerializedName("air quality") val airQuality: AirQuality) 


data class AirQuality(val aqi: AQI) 


data class AQI(val chn: Float) 


} 


注意 ， 这 里 我 们 将 所 有 的 数据 模型 类 都 定义 在 了 RealtimeResponse 的 内 部 ， 这 样 可 以 防止 出 
现 和 其 他 接口 的 数据 模型 类 有 同名 冲突 的 情况 。 


接 下 来 我 们 再 回顾 一 下 获取 未 来 几 天 天 气 信 息 接口 所 返回 的 ISON 数 据 格式 ， 简 化 后 的 内 容 如 下 
所 示 : 


{ 
"status": "ok", 
"result": { 
"daily": { 
"temperature": [ {"max": 25.7, "min": 20.3}, ... ], 
"skycon": [ {"value": "CLOUDY", "date":"2019-10-20T00:00+08:00"},，... ]， 
"life index": { 
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"coldRisk": [ 上 'desc" " 易 发 " By, sma. 
"carWashing": [ {" dese" "适宜 "}，... ]】， 
"ultraviolet": [人 ‘desc" WD 
"dressing": [ {"desc" "舒适" 下 


这 段 SON 数 据 格式 最 大 的 特别 之 处 在 于 , 它 返 回 的 天 气 数 据 全 部 是 数组 形式 的 ， 数 组 中 的 每 个 
元 素 都 对 应 着 一 天 的 数据 。 在 数据 模型 中 ， 我 们 可 以 使 用 List 集 合 来 对 SON 中 的 数组 元 素 进 行 
映射 。 同 样 在 logic/model 包 下 新 建 一 个 DailyResponse.kt 文 件 ， 并 编写 如 下 代码 : 
data class DailyResponse(val status: String, val result: Result) { 

data class Result(val daily: Daily) 


data class Daily(val temperature: List<Temperature>, val skycon: List<Skycon>, 
@SerializedName("life index") val LifeIndex: LifeIndex) 


data class Temperature(val max: Float, val min: Float) 

data class Skycon(val value: String, val date: Date) 

data class LifeIndex(val coldRisk: List<LifeDescription>, val carWashing: 
List<LifeDescription>, val ultraviolet: List<LifeDescription>, 


val dressing: List<LifeDescription>) 


data class LifeDescription(val desc: String) 


这 次 我 们 将 所 有 的 数据 模型 类 都 定义 在 了 DailyResponse 的 内 部 ， Ce 虽然 它 和 
RealtimeResponse 内 部 都 包含 了 一 个 Result 类 ,但 是 它们 之 间 是 完全 不 会 冲突 的 。 


另外 ,我 们 还 需要 在 logic/model 包 下 再 定义 一 个 Weather 类 ， 用 于 将 Realtime 和 Daily 对 象 
封装 起 来 ， 代 码 如 下 所 示 : 


data class Weather(val realtime: RealtimeResponse.Realtime, val daily: DailyResponse.Daily) 


将 数据 模型 都 定义 好 了 之 后 ， 接 下 来 又 该 2 员 写 网 络 层 相关 的 代码 了 。 你 会 发 现 使 用 这 种 分 
层 架 构 的 设计 ,每 步 应 该 做 什么 都 非常 清 帅 


现在 定义 一 个 用 于 访问 天 气 信 息 API 的 Retrofit 接 口 ， 在 logic/network 包 下 新 建 
WeatherService 接 口 ， 代码 如 下 所 示 : 


interface WeatherService { 


@GET("v2.5/${SunnyWeatherApplication.TOKEN}/{lng}, {lat}/realtime.json") 
fun getRealtimeWeather(@Path("lng") lng: String, @Path("lat") lat: String): 
Call<RealtimeResponse> 


@GET("v2.5/${SunnyWeatherApplication.TOKEN}/{lng}, {lat}/daily.json") 
fun getDailyweather(@Path("lng") lng: String, @Path("lat") lat: String): 
Call<DailyResponse> 
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可 以 看 到 ， 这 里 我 们 定义 了 两 个 方法 : getReaLtimewWeather ( ) 方 法 用 于 获取 实时 的 天 气 信 
息 , getDailyWeather() 方 法 用 于 获取 未 来 的 天 气 信息 。 在 每 个 方法 的 上 面 仍然 还 是 使 用 
@GET 注 解 来 声明 要 访问 的 API 接 口 ， 并 且 我 们 还 使 用 了 G@Path 注 解 来 向 请 求 接口 中 动态 传 入 经 
纬度 的 坐标 。 这 两 个 方法 的 返回 值 分 别 被 声明 成 了 Call<RealtimeResponse> 和 
Call<DailyResponse>，, 对 应 了 刚刚 定义 好 的 两 个 数据 模型 类 。 


接 下 来 我 们 需要 在 SunnyWeatherNetwork 这 个 网 络 数据 源 访 问 入 口 对 新 增 的 
WeatherService 接 口 进行 封装 。 修 改 SunnyWeatherNetwork 中 的 代码 ， 如 下 所 示 : 
object SunnyWeatherNetwork { 

private val weatherService = 9erviceCreator.create(Weather9ervice::cLass. javal) 


suspend fun getDailyWeather(lng: String, lat: String) = 
weatherService.getDailyWeather(lng, lat).await() 


suspend fun getRealtimeWeather(lng: String, lat: String) = 
weatherService.getRealtimeWeather(lng, lat).await() 


} 


你 会 发 现 ， 这 里 对 WeatherService 接 口 的 封装 和 之 前 对 PLaceService 接 口 的 封装 写法 几乎 
是 一 模 一 样 的 ， 就 算是 依 葫芦 画 球 也 能 写 得 出 来 。 所 以 这 种 分 层 架 构 设 计 的 扩展 性 真 的 非常 
好 ， 不 管 以 后 要 扩展 多 少 新 功能 ， 我 们 都 能 按照 非常 相似 的 步 又 去 实现 。 


完成 了 网 络 层 的 代码 编写 ， 接 下 来 很 容易 想到 应 该 去 仓库 层 进 行 相 关 的 代码 实现 了 。 修 改 
Repository 中 的 代码 ,如 下 所 示 : 


object Repository { 


fun refreshweather(Lng: String, lat: String) = liveData(Dispatchers.10) { 
val result = try { 
coroutineScope { 
val deferredRealtime = async { 
SunnyWeatherNetwork.getRealtimeWeather(lng, lat) 
} 


val deferredDaily = async { 
SunnyWeatherNetwork.getDailyWeather(lng, lat) 
} 


val realtimeResponse = deferredRealtime.await() 
val dailyResponse = deferredDaily.await() 
if (realtimeResponse.status == "ok" && dailyResponse.status == "ok") { 
val weather = Weather(realtimeResponse.result.realtime, 
dailyResponse.result.daily) 
Result.success (weather) 
} else { 
Result.failurel( 
RuntimeException( 
"realtime response status is ${realtimeResponse.status}" + 
"daily response status is ${dailyResponse.status}" 


} 


} catch (e: Exception) { 
Result.failure<Weather>(e) 
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emit(result) 
} 
} 


注意 ， 在 仓库 层 我 们 并 没有 提供 两 个 分 别 用 于 获取 实时 天 气 信息 和 未 来 天 气 信息 的 方法 ， 而 是 
提供 了 一 个 refreshweather( ) 方 法 用 来 刷新 天 气 信 息 。 因 为 对 于 调用 方 而 言 ， 需 要 调用 两 次 
请 求 才 能 获得 其 想 要 的 所 有 天 和 气 数据 明显 是 比较 烦琐 的 行为 ， 因 此 最 好 的 做 法 就 是 在 仓库 层 再 
进行 一 次 统一 的 封装 。 


不 过 ， 获 取 实 时 天 气 信息 和 获取 未 来 天 气 信息 这 两 个 请 求 是 没有 先后 顺序 的 ， 因 此 让 它们 并 发 
执行 可 以 提升 程序 的 运行 效率 ， 但 是 要 在 同时 得 到 它们 的 响应 结果 后 才能 进一步 执行 程序 。 这 
种 需求 有 没有 让 你 想起 什么 呢 ? 没 错 ， 这 不 恰好 就 是 我 们 在 第 11 章 学 习 协 程 时 使 用 的 async 也 | 
数 的 作用 吗 ? 只 需要 分 别 在 两 个 async 盟 数 中 发 起 网 络 请 求 ， 然 后 再 分 别 调用 它们 的 await () 
方法 ， 就 可 以 保证 只 有 在 两 个 网 络 请 求 都 成 功 响 应 之 后 ， 才 会 进一步 执行 程序 。 另 外 ,由 于 
async 函 数 必 须 在 协 程 作 用 域内 才能 调用 ， 所 以 这 里 又 使 用 coroutineScope 国 数 创 建 了 一 个 
协 程 作用 域 。 


接 下 来 的 逻辑 就 比较 简单 了 ， 在 同时 获取 到 RealtimeResponse 和 DailyResponse 之 后 ,如 
果 它 们 的 响应 状态 都 是 ok ,那么 就 将 ReaLtime 和 DaitLy 对 象 取 出 并 封装 到 一 个 Weather 对 象 
中 ， 然 后 使 用 ResutLt .success ( ) 方 法 来 包装 这 个 Weather 对 象 ， 否 则 就 使 用 
Result.failure() 方 法 来 包装 一 个 异常 信息 ， 最 后 调用 emit( ) 方 法 将 包装 的 结果 发 射出 
去 。 


一 般 代码 写 到 这 里 就 已 经 足够 好 了 ， 但 是 其 实 我 们 还 可 以 做 到 更 好 。 你 会 发 现 ， 由 于 我 们 使 用 

了 协 程 来 简化 网 络 回调 的 写法 ， 导 致 SunnyWeatherNetwork 中 封装 的 每 个 网 络 请 求 接口 都 可 
能 会 抛 出 异常 ， 于 是 我 们 必须 在 仓库 层 中 为 每 个 网 络 请 求 都 进行 try catch 处 理 ， 这 无 疑 增加 了 
仓库 层 代码 实现 的 复杂 度 。 然 而 之 前 我 就 说 过 ， 其 实 完 全 可 以 在 某 个 统一 的 入 口 函 数 中 进行 封 

装 ， 使 得 只 要 进行 一 次 try catch 处 理 就 行 了 ， 下 面 我 们 就 来 学 习 一 下 具体 应 该 怎样 实现 。 


object Repository { 


fun searchPLaces(query: String) = fire(Dispatchers.10) { 
val placeResponse = SunnyWeatherNetwork.searchPLaces(query) 
if (placeResponse.status == "ok") { 
val places = placeResponse.places 
Result. success(places) 
} else { 
Result.failure(RuntimeException("response status is ${placeResponse.status}")) 


} 


fun refreshweather(Lng: String, lat: String) = fire(Dispatchers.10) { 
coroutineScope { 
val deferredRealtime = async { 
SunnyWeatherNetwork.getRealtimeWeather(lng, lat) 
} 


val deferredDaily = async { 
SunnyWeatherNetwork.getDailyWeather(lng, lat) 
} 


val realtimeResponse = deferredRealtime.await() 
val dailyResponse = deferredDaily.await() 
if (realtimeResponse.status == "ok" && dailyResponse.status == "ok") { 
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val weather = Weather(realtimeResponse,.result.realtime, 
dailyResponse.result.daily) 

Result.success (weather) 

} else{ 

Result.failurel( 

RuntimeException( 
"realtime response status is ${realtimeResponse.status}" + 
"daily response status is ${dailyResponse.status}" 


} 
private fun <T> fire(context: CoroutineContext, block: suspend () -> Result<T>) = 
liveData<Result<T>>(context) { 
val result = try { 
block() 
} catch (e: Exception) { 
Result.failure<T>(e) 


emit(result) 


} 


这 段 代 码 最 核心 的 地 方 就 在 于 我 们 新 增 的 fire( ) 函数 ,这 是 一 个 按照 LiveData( ) 函数 的 参数 
接收 标准 定义 的 一 个 高 阶 函 数 。 在 fire ( ) 函数 的 内 部 会 先 调 用 一 人 LiveData ( ) 函数 ， 然 后 在 
LiveData( ) 函 数 的 代码 块 中 统一 进行 了 try catch 处 理 ， 并 在 try 语 名 中 调用 传 入 的 Lambda 

表达 式 中 的 代码 ， 最 终 获 取 Lambda 表 达 式 的 执行 结果 并 调用 emit ( ) 方 法 发 射出 去 。 


另外 还 有 一 点 需要 注意 ,在 LiveData( ) 函数 的 代码 块 中 ， 我 们 是 拥有 挂 起 上 范 数 上 下 文 的 ， 可 
是 当 回调 到 Lambda 表 达 式 中 ， 代 码 就 没有 挂 起 盟 数 上 下 文 了 ， 但 实际 上 Lambda 表 达 式 中 的 
代码 一 定 也 是 在 挂 起 水 数 中 运行 的 。 为 了 解决 这 个 问题 ， 我 们 需要 在 哨 数 类 型 前 声明 一 个 
suspend 关 键 字 ， 以 表示 所 有 传 入 的 Lambda 表 达 式 中 的 代码 也 是 拥有 挂 起 浮 数 上 下 文 的 。 


定义 好 了 fire() 范 数 之 后 ， 剩 下 的 工作 就 很 简单 了 。 只 需要 分 别 将 searchPLaces ( ) 和 
refreshWeather() 方 法 中 调用 的 LiveData( ) 函数 蔡 换 成 fi re ( ) 函 数 ， 然 后 把 诸如 try 
catch 语 句 、emit () 方 法 之 类 的 逻辑 移 除 即 可 。 这 样 ， 仓 库 层 中 的 代码 就 变 得 更 加 简洁 清晰 
fs 


写 到 这 里 ， 逻辑 层 的 实现 就 只 剩 最 后 一 步 了 : 定义 ViewModel 层 。 在 ui/weather 包 下 新 建 一 个 
WeatherViewModel , 代码 如 下 所 示 : 


class WeatherViewModel : ViewModel() { 
private val locationLiveData = MutableLiveData<Location>() 
Var LocationLng = "" 


Var LocationLat = "" 


var placeName = "" 


val weatherLiveData = Transformations.switchMap(locationLiveData) { Location -> 
Repository.refreshWeather(location.lng, location. lat) 


} 
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fun refreshweather(Lng: String, lat: String) { 
locationLiveData.value = Location(lng, lat) 
} 


} 


WeatherViewModel 中 的 代码 也 是 极其 简单 的 ， 这 里 定义 了 一 个 refreshweather() 方 法 来 
刷新 天 气 信息 ， 并 将 传 入 的 经 纬度 参数 封装 成 一 个 Location 对 象 后 赋值 给 
LocationLiveData 对 象 ， 然 后 使 用 Transformations 的 SwitchMap ( ) 方 法 来 观察 这 个 对 
象 ， 并 在 switchMap ( ) 方 法 的 转换 函数 中 调用 仓库 层 中 定义 的 refreshWeather() 方 法 。 这 
样 ， 仓 库 层 返回 的 LiveData 对 象 就 可 以 转换 成 一 个 可 供 Activity 观 察 的 LiveData 对 象 了 。 


另外 , 我们 还 在 WeatherViewModel 中 定义 了 locationLng、locationLat 和 placeName 
这 3 个 变量 ， 它 们 都 是 和 界面 相关 的 数据 ， 放 到 ViewModel 中 可 以 保证 它们 在 手机 屏幕 发 生 旋 
转 的 时 候 不 会 丢失 ， 稍 后 在 编写 UIl 层 代码 的 时 候 会 用 到 这 几 个 变量 。 


这 样 我 们 就 将 逻辑 层 的 代码 实现 全 部 完成 了 ， 接 下 来 又 该 去 编写 界面 了 。 
15.5.2 实现 UI 层 代码 


首先 创建 一 个 用 于 显示 天 气 信 息 的 Activity。 右 击 ui/weather 包 NewActivity>Empty 
Activity ,创建 一 个 WeatherActivity， 并 将 布局 名 指定 成 activity weather.xml。 


由 于 所 有 的 天 气 信息 都 将 在 同一 个 界面 上 显示 ， 因 此 activity weatherXxml 会 是 一 个 很 长 的 布 
局 文件 。 那 么 为 了 让 里 面 的 代码 不 至 于 混乱 不 堪 ， 这 里 我 准备 使 用 4.4.1 小 节 学 过 的 引入 布局 技 
术 , 将 界面 的 不 同 部 分 写 在 不 同 的 布局 文件 里 面 ， 再 通过 引入 布局 的 方式 集成 到 

activity weatherxml 中 ,这样 整 个 布局 文件 就 会 显得 更 加 工整 。 


右 击 res/layout>New 一 Layout resource file , 新建 一 个 now.xml 作 为 当前 天 气 信 息 的 布局 ， 
代码 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/nowLayout" 
android:layout width="match parent" 
android:layout height="530dp" 
android:orientation="vertical"> 


<FrameLayout 
android:id="@+id/titleLayout" 
android:layout width="match parent" 
android:layout height="70dp"> 


<TextView 
android:id="@+id/placeName" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout marginStart="60dp" 
android:layout marginEnd="60dp" 
android:layout gravity="center" 
android:singleLine="true" 
android:ellipsize="middle" 
android:textColor="#fff" 
android:textSize="22sp" /> 
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</FrameLayout> 


<LinearLayout 
android:id="@+id/bodyLayout" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:orientation="vertical"> 


<TextView 
android:id="@+id/currentTemp" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:textColor="#fff" 
android:textSize="70sp" /> 


<LinearLayout 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout gravity="center horizontal" 
android:layout marginTop="20dp"> 


<TextView 
android:id="@+id/currentSky" 
android:Layout width="wrap_ content" 
android:layout height="wrap content" 
android:textColor="#fff" 
android:textSize="18sp" /> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginStart="13dp" 
android:textColor="#fff" 
android:textSize="18sp" 
android:text="|" /> 


<TextView 
android:id="@+id/currentAQI" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:Layout marginStart="13dp" 
android:textColor="#fff" 
android:textSize="18sp" /> 


</LinearLayout> 


</LinearLayout> 


</RelativeLayout> 


这 上段 代码 还 是 比较 简单 的 ， 主 要 分 为 上 下 两 个 布局 : 上 半 部 分 是 头 布局 ,里面 只 放置 了 一 个 
TextView ,用 于 显示 城市 名 ; 下 半 部 分 是 当前 天 气 信息 的 布局 ， 里面 放置 了 几 个 TextView， 分 
别 用 于 显示 当前 气温 、 当 前 天 和 气 情况 以 及 当前 空气 质量 。 


然后 新 建 forecast.xml 作 为 未 来 几 天 天 气 信息 的 布局 ， 代 码 如 下 所 示 : 


<com.google.android.material.card.MaterialCardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
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android:Layout width="match parent" 
android:layout height="wrap content" 
android:Layout marginLeft="15dp" 
android:layout marginRight="15dp" 
android:Layout marginTop="15dp" 
app:cardCornerRadius="4dp"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginStart="15dp" 
android:layout marginTop="20dp" 
android:layout marginBottom="20dp" 
android:text=" 预 报 " 
android:textColor="?android:attr/textColorPrimary" 
android:textSize="20sp"/> 


<LinearLayout 
android:id="@+id/forecastLayout" 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 
</LinearLayout> 


</LinearLayout> 


</com.google.android.material.card.MaterialCardView> 


最 外 层 使 用 了 MaterialCardView 来 实现 卡片 式 布局 的 背景 效果 ， 然 后 使 用 TextView 定 义 了 一 
个 标题 ， 接 着 又 使 用 一 个 LinearLayout 定 义 了 一 个 用 于 显示 未 来 几 天 天 气 信 息 的 布局 。 不 过 这 
个 布局 中 并 没有 放 入 任何 内 容 ， 因 为 这 是 要 根据 服务 器 返回 的 数据 在 代码 中 动态 添加 的 。 


为 此 ， 我们 需要 再 定义 一 个 未 来 天 气 信 息 的 子 项 布局 ,创建 forecast_item.xmI 文 件 ， 代码 如 
下 所 示 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="15dp"> 


<TextView 
android:id="@+id/dateInfo" 
android:Layout width="0dp" 
android:Layout height="wrap content" 
android:layout gravity="center vertical" 
android:layout weight="4" /> 


<ImageView 
android:id="@+id/skylcon" 
android:Layout width="20dp" 
android:layout height="20dp" /> 


<TextView 
android:id="@+id/skyInfo" 
android:Layout width="0dp" 
android:Layout height="wrap content" 
android:layout gravity="center vertical" 
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android:Layout weight="3" 
android:gravity="center" /> 


<TextView 
android:id="@+id/temperatureInfo" 
android:Layout width="Qdp" 
android:layout height="wrap content" 
android:layout gravity="center vertical" 
android:layout weight="3" 
android:gravity="end" /> 


</LinearLayout> 


这 个 子 项 布局 包含 了 3 个 TextView 和 1 个 ImageView， 分别 用 于 显示 天 气 预报 的 日 期 、 天 和 气 的 
图 标 、 天 气 的 情况 以 及 当天 的 最 低温 度 和 最 高 温度 。 


然后 新 建 life_index.xml 作 为 生活 指数 的 布局 ,代码 如 下 所 示 : 


<com.google.android.material.card.MaterialCardView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout margin="15dp" 
app:cardCornerRadius="4dp"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginStart="15dp" 
android:layout marginTop="20dp" 
android:text=" 生 活 指数 " 
android:textColor="?android:attr/textColorPrimary" 
android:textSize="20sp"/> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginTop="20dp"> 


<RelativeLayout 
android:layout width="0dp" 
android:layout height="60dp" 
android:Layout weight="1"> 


<ImageView 
android:id="@+id/coldRiskImg" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginStart="20dp" 
android:src="@drawable/ic coldrisk" /> 


<LinearLayout 
android:layout width="wrap _ content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout toEnd0f="@id/coldRiskImg" 
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android:Layout marginStart="20dp" 
android:orientation="vertical"> 


<TextView 
android 
android 
android 
android 


<TextView 
android 
android 
android 
android 
android 
android 
</LinearLayout> 


</RelativeLayout> 


<RelativeLayout 


:layout width="wrap_ content" 
:layout height="wrap content" 
:textSize="12sp" 

:text=" 感 冒 " /> 


:id="@+id/coldRiskText" 

:Layout width="wrap content" 

:layout height="wrap content" 

:layout marginTop="4dp" 

:textSize="16sp" 
:textColor="?android:attr/textColorPrimary" /> 


android:Layout width="0dp" 
android:layout height="60dp" 
android:Layout weight="1"> 


<ImageView 


android:id=" 


'@+id/dressingImg" 


android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginStart="20dp" 
android:src="@drawable/ic dressing" /> 


<LinearLayout 


android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 


android:Layout toEnd0f="@id/dressingImg 


android:layout marginStart="20dp" 
android:orientation="vertical"> 


<TextView 
android 
android 
android 
android 


<TextView 
android 
android 
android 
android 
android 
android 
</LinearLayout> 


</RelativeLayout> 
</LinearLayout> 


<LinearLayout 


:Layout width="wrap content" 
:layout height="wrap content" 
:textSize="12sp" 

:text=" 穿 衣 " /> 


:id="@+id/dressingText" 

:layout width="wrap content" 

:layout height="wrap content" 

:layout marginTop="4dp" 

:textSize="16sp" 
:textColor="?android:attr/textColorPrimary" /> 


android:layout width="match parent" 
android:layout height="wrap content" 
android:layout marginBottom="20dp"> 
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<RelativeLayout 
android:layout width="0dp" 
android:layout height="60dp" 
android:Layout weight="1"> 


<ImageView 
android:id="@+id/ultravioletImg" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginStart="20dp" 
android:src="@drawable/ic ultraviolet" /> 


<LinearLayout 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:layout toEnd0f="@id/ultravioletImg" 
android:layout marginStart="20dp" 
android:orientation="vertical"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:textSize="12sp" 
android:text=" 实 时 紫外 线 " /> 


<TextView 
android:id="@+id/ultravioletText" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginTop="4dp" 
android:textSize="16sp" 


android:textColor="?android:attr/textColorPrimary" /> 


</LinearLayout> 
</RelativeLayout> 


<RelativeLayout 
android:layout width="0dp" 
android:layout height="60dp" 
android:Layout weight="1"> 


<ImageView 
android:id="@+id/carWashingImg" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerVertical="true" 
android:layout marginStart="20dp" 
android:src="@drawable/ic carwashing" /> 


<LinearLayout 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout centerInParent="true" 
android:Layout toEnd0f="@id/carWashingImg 
android:layout marginStart="20dp" 
android:orientation="vertical"> 


<TextView 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:textSize="12sp" 
android:text=" 洗 车 " /> 
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<TextView 

android:id="@+id/carWashingText" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
android:layout marginTop="4dp" 
android:textSize="16sp" 
android:textColor="?android:attr/textColorPrimary" /> 

</LinearLayout> 


</RelativeLayout> 
</LinearLayout> 


</LinearLayout> 


</com.google.android.material.card.MaterialCardView> 


这 个 布局 中 的 代码 虽然 看 上 去 很 长 ， 但 是 并 不 复杂 。 其 实 它 就 是 定义 了 一 个 四 方 格 的 布局 ,分 
别 用 于 显示 感冒 、 穿 胡 、 实 时 紫外 线 以 及 洗车 的 指数 。 所 以 只 要 看 懂 其 中 一 个 方 格 中 的 布局 ， 
其 他 方 格 中 的 布局 自然 就 明白 了 。 每 个 方 格 中 都 有 一 个 ImageView 用 来 显示 图 标 ， 一 个 
TextView 用 来 显示 标题 ， 还 有 一 个 TextView 用 来 显示 指数 。 相 信 你 只 要 仔细 看 一 看 ， 这 个 布局 
还 是 很 好 理解 的 。 


这 样 我 们 就 把 天 气 界面 上 每 个 部 分 的 布局 文件 都 编写 好 了 ， 接 下 来 的 工作 就 是 将 它们 引入 
activity_weather.xml 中 ， 如 下 所 示 : 


<ScrollView 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/weatherLayout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:scrollbars="none" 
android:overScrollMode="never" 
android:visibility="invisible"> 


<LinearLayout 
android:orientation="vertical" 
android:layout width="match parent" 
android:layout height="wrap content"> 
<include layout="@layout/now" /> 
<include layout="@layout/forecast" /> 
<include layout="@layout/life index" /> 


</LinearLayout> 


</ScrollView> 


可 以 看 到 ， 最 外 层 布 局 使 用 了 一 个 ScrollView ,这 是 因为 天 气 界 面 中 的 内 容 比较 多 ， 使 用 
ScrollView 就 可 以 通过 滚动 的 方式 查看 屏幕 以 外 的 内 容 。 由 于 ScrollView 的 内 部 只 允许 存在 一 
个 直接 子 布局 , 因此 这 里 又 谋 套 了 一 个 垂直 方向 的 LinearLayout , 然后 在 LinearLayout 中 将 
刚才 定义 的 所 有 布局 逐个 引入 。 


注意 ， 一 开始 的 时 候 我 们 是 将 ScrollView 隐 藏 起 来 的 ， 不 然 空 数据 的 界面 看 上 去 会 很 奇怪 。 等 
到 天 气 数据 请 求 成 功 之 后 ， 会 通过 代码 的 方式 再 将 ScrollView 显 示 出 来 。 


www.blogss.cn 


这 样 我 们 就 将 天 气 界面 布局 编写 完成 了 ， 接 下 来 应 该 去 实现 WeatherActivity 中 的 代码 了 。 不 
过 在 这 之 前 ， 我 们 还 要 编写 一 个 额外 的 转换 函数 。 因 为 彩云 天 气 返回 的 数据 中 ， 天 气 情况 都 是 
一 些 诸如 CLOUDY、WIND 之 类 的 天 气 代码 ， 我 们 需要 编写 一 个 转换 函数 将 这 些 天 气 代码 转换 成 
一 个 Sky 对 象 。 在 logic/model 包 下 新 建 一 个 Sky.kt 文 件 ， 代 码 如 下 所 示 : 


class Sky (val info: String, val icon: Int, val bg: Int) 


private val Sky = mapof( 
"CLEAR DAY"” to Sky(" 晴 "，R.drawable.ic clear day, R.drawable.bg clear day)， 
"CLEAR NIGHT" to Sky(" 晴 "，R.drawable.ic clear night, R.drawable.bg clear night)， 
"PARTLY_CLOUDY_DAY" to Sky(" 多 云 ", R.drawable.ic partly cloud day, 
R.drawable.bg partly cloudy day), 
"PARTLY_CLOUDY_NIGHT" to Sky(" 多 云 ", R.drawable.ic partly cloud night, 
R.drawable.bg partly cloudy night), 
"CLOUDY" to Sky(" 阴 ", R.drawable.ic cloudy, R.drawable.bg cloudy), 
"WIND"” to Sky(" 大 风 "，R.drawable.ic cloudy, R.drawable.bg wind)，, 
"LIGHT_RAIN" to Sky(" 小 雨 "，R.drawable.ic light rain, R.drawable.bg rain)， 
"MODERATE RAIN" to Sky(" 中 雨 ", R.drawable.ic moderate rain, R.drawable.bg rain)，, 
"HEAVY RAIN"” to Sky(" 大 雨 "，R.drawabtLe.ic heavy rain, R.drawable.bg rain)， 
"STORM RAIN"” to Sky(" 暴 十 ",，R.drawable.ic storm rain, R.drawable.bg rain)， 
"THUNDER SHOWER"” to Sky ("雷阵雨 "，R.drawable.ic thunder shower, R.drawable.bg rain)，, 
"SLEET" to Sky(" 雨 夹 雪 "，R.drawable.ic sleet, R.drawable.bg rain)，, 
"LIGHT_SNOW"” to Sky(" 小 雪 "，R.drawable.ic light snow, R.drawable.bg snow)， 
"MODERATE SNOW"” to Sky(" 中 雪 "，R.drawabtLe.ic moderate snow, R.drawable.bg snow)， 
"HEAVY_SNOW"” to Sky ("大雪 "，R.drawable.ic heavy_snow, R.drawable.bg_ snow)， 
"STORM SNOW" to Sky(" 暴 雪 "， R.drawable.ic heavy snow, R.drawable.bg _ snow)， 
"HAIL"” to Sky(" 冰 埋 "，R.drawable.ic hail, R.drawable.bg snow)， 
"LIGHT_HAZE" to Sky(" 轻 度 雾 者 "，R.drawable.ic light haze, R.drawable.bg fog)， 
"MODERATE HAZE" to Sky(" 中 度 雾 圳 " ，R.drawabtLe.ic moderate haze, R.drawable.bg fog)， 
"HEAVY_HAZE" to Sky ("重度 雾 者 "，R.drawable.ic heavy haze, R.drawable.bg fog)， 
"FO0G" to Sky(" 雾 "，R.drawabtLe.ic fog, R.drawable.bg fo0g), 
"DUST"” to Sky(" 浮 尘 "，R.drawable.ic fog, R.drawable.bg fog) 
) 


fun getSky(skycon: String): Sky { 
return sky[skycon] ?: sky["CLEAR DAY"]!! 
} 


可 以 看 到 ,这 里 首先 定义 了 一 个 Sky 类 作为 数据 模型 ， 它 包含 了 info、icon 和 bg 这 3 个 字段 ， 
分 别 表 示 该 天 气 情况 所 对 应 的 文字 、 图 标 和 背景 。 然 后 使 用 map0f ( ) 函数 来 定义 每 种 天 气 代码 
所 应 该 对 应 的 文字 、 图 标 和 背景 。 不 过 我 没 能 给 每 种 天 气 代码 都 准备 一 份 对 应 的 图 标 与 背景 ， 
因此 对 于 一 些 类 型 比较 相近 的 天 气 ， 这 里 就 使 用 同一 份 图 标 或 背景 了 。 最 后 ， 定义 了 一 个 
getSky ( ) 方 法 来 根据 天 气 代 码 获取 对 应 的 Sky 对 象 ， 这 样 转 换 函 数 就 写 好 了 。 


接 下 来 我 们 就 可 以 在 WeatherActivity 中 去 请 求 天 气 数 据 ， 并 将 数据 展示 到 界面 上 。 修 改 
WeatherActivity 中 的 代码 ， 如 下 所 示 : 


class WeatherActivity : AppCompatActivity() { 
val viewModel by lazy { ViewModelProvider(this).get(WeatherViewModel::class.java) } 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity weather) 
if (viewModel.locationLng.isEmpty()) { 
viewModel.locationLng = intent.getStringExtra("location lng") ?: "" 
} 
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if (viewModel.locationLat.isEmpty()) { 
viewModel.locationLat = intent.getStringExtra("location lat") ?: "" 


if (viewModel.placeName.isEmpty()) { 
viewModel .placeName = intent.getStringExtra("place name") ?: "" 


viewModel .weatherLiveData.observe(this, Observer { result -> 
val weather = result.getOrNull() 
if (weather != null) { 
showWeatherInfo (weather) 
} else{ 
Toast.makeText (this，“" 无 法 成 功 获取 天 气 信 息 "，Toast ,LENGTH_SHORT) .show() 
result.exceptionOrNull()?.printStackTrace() 


} 
}) 
viewModel .refreshWeather(viewModel.locationLng, viewModel .locationLat) 


} 


private fun showWeatherIinfo(weather: Weather) { 
placeName. text = viewModel .placeName 
val realtime = weather. realtime 
val daily = weather.daily 
// 填充 now.xml 布 局 中 的 数据 
val currentTempText = "${realtime.temperature.toInt()} °C" 
currentTemp ,text = currentTempText 
currentSky.text = getSky(realtime.skycon).info 
val currentPM25Text = "空气 指数 ${realtime.airQuality.aqi.chn.toInt()}" 
currentAQI .text = currentPM25Text 
nowLayout.setBackgroundResource(getSky(realtime.skycon).bg) 
// 填充 forecast.xml 布 局 中 的 数据 
forecastLayout.removeAllViews() 
val days = daily.skycon.size 
for (i in © until days) { 
val skycon = daily.skycon[i] 
val temperature = daily.temperaturel[i] 
val view = LayoutInflater.from(this).inflate(R.layout.forecast item， 
forecastLayout, false) 
val dateInfo = view.findViewById(R.id.dateInfo) as TextView 
val SkyIcon = view.findViewById(R.id,.skyIcon) as ImageView 
val skyInfo = view.findViewById(R.id.skyInfo) as TextView 
val temperatureInfo = view.findViewById(R.id.temperatureInfo) as TextView 
val simpleDateFormat = SimpleDateFormat("yyyy-MM-dd", Locale.getDefault()) 
dateInfo.text = simpleDateFormat.format(skycon.date) 
val sky = getSky(skycon.value) 
SkyIcon.SsetImageResource(Sky.icon) 
SkyInfo.text = sky.info 
val tempText = "${temperature.min.toInt()} ~ ${temperature.max.toInt()} °C" 
temperatureInfo.text = tempText 
forecastLayout.addView(view) 


} 

// 填充 Life_index .xml 布 局 中 的 数据 
val LifeIndex = daily.lifeIndex 

coldRiskText.text = LifeIndex.coLdRisk[0].desc 
dressingText.text = lifeIndex.dressing[0].desc 
ultravioletText.text = lifeIndex.ultraviolet[0].desc 
carWashingText.text = lifeIndex.carWashing[0].desc 
weatherLayout.visibility = View.VISIBLE 


这 段 代 码 也 比较 长 ， 我 们 还 是 一 步 步 梳理 下 。 在 onCreate( ) 方 法 中 ,首先 从 Intent 中 取出 经 
纬度 坐标 和 地 区 名 称 ， 并 赋值 到 WeatherViewModel 的 相应 变量 中 ; 然后 对 
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weatherLiveData 对 象 进 行 观察 ， 当 获取 到 服务 器 返回 的 天 气 数据 时 ， 就 调用 
showweatherInfo() 方 法 进行 解析 与 展示 ; 最 后 , 调用 了 WeatherViewModel 的 
refreshWeather() 方 法 来 执行 一 次 刷新 天 气 的 请 求 。 


至 于 showWeatherInfo() 方 法 中 的 逻辑 就 比较 简单 了 ， 其 实 就 是 从 Weather 对 象 中 获取 数 
据 ， 然后 显示 到 相应 的 控件 上 上。 注意 ， 在 未 来 几 天 天 和 气 预报 的 部 分 ， 我 们 使 用 了 一 个 for- in 循 
环 来 处 理 每 天 的 天 气 信息 ， 在 循环 中 动态 加 载 forecast_item.xml 布 局 并 设置 相应 的 数据 ， 然 
后 添加 到 父 布局 中 。 另 外 ， 生 活 指 数 方面 虽然 服务 器 会 返回 很 多 天 的 数据 ,但 是 界面 上 只 需要 
当天 的 数据 就 可 以 了 ， 因 此 这 里 我 们 对 所 有 的 生活 指数 都 取 了 下 标 为 零 的 那个 元 素 的 数据 。 设 
置 完了 所 有 数据 之 后 ， 记 得 要 让 ScrollView 变 成 可 见 状 态 。 


编写 完了 WeatherActivity 中 的 代码 ， 接 下 来 我 们 还 有 一 件 事情 要 做 ， 就 是 要 能 从 搜索 城市 界 
面 跳 转 到 天 气 界面 。 修 改 PlaceAdapter 中 的 代码 ,如 下 所 示 : 


class PLaceAdapter(private val fragment: Fragment, private val pLaceList: List<PLace>) : 
RecyclerView.Adapter<PlaceAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context).inflate(R.Tlayout.place item, 
parent, false) 
val holder = ViewHolder(view) 
holder.itemView.setOnClickListener { 
val position = holder.adapterPosition 
val place = placeList[position] 
val intent = Intent(parent.context, WeatherActivity::class.java).apply { 
putExtra("location lng", place.location.lng) 
putExtra("location lat", place.location.lat) 
putExtra("place name", place.name) 
} 
fragment.startActivity(intent) 
fragment .activity?.finish() 


return holder 


D 


非常 简单 ， 这 里 我 们 给 place_item.xml 的 最 外 层 布 局 注册 了 一 个 点 击 事件 监听 器 ， 然 后 在 点 击 
事件 中 获取 当前 点 击 项 的 经 纬度 坐标 和 地 区 名 称 ， 并 把 它们 传 入 Intent 中 ， 最 后 调用 Fragment 
的 startActivity() 方 法 启动 WeatherActivity。 


好 了 ， 现 在 重新 运行 一 下 程序 ， 在 搜索 框 中 输入 “北京 ”, 并 选择 “北京 市 ”, 结果 如 图 15.24 所 
不 。 
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预报 


2019-10-25 » 多 云 4~13C 


图 15.24 显示 天 气 信息 
然后 我 们 还 可 以 向 下 滑动 查看 更 多 天 气 信息 ， 如 图 15.25 所 示 。 
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图 15.25 查看 更 多 天 气 信息 


不 过 如 果 你 仔细 观察 上 图 ， 就 会 发 现 背 景 图 并 没有 和 状态 栏 融合 到 一 起 ， 这 样 的 视觉 体验 还 没 
有 达到 最 佳 的 效果 。 虽 说 我 们 在 12.7.2 小 节 已 经 学 习 过 如 何 将 背景 图 和 状态 栏 融 合 到 一 起 , 但 
当时 是 借助 Material 库 完成 的 ， 实 现 过 程 也 比较 麻烦 。 这 里 我 准备 教 你 另外 一 种 更 简单 的 实现 
方式 。 修 改 WeatherActivity 中 的 代码 ， 如 下 所 示 : 


class WeatherActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
val decorView = window.decorView 
View.SYSTEM UI FLAG LAYOUT FULLSCREEN 
or View.SYSTEM UI FLAG LAYOUT STABLE 
window.statusBarColor = Color.TRANSPARENT 
setContentView(R.layout.activity weather) 
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我 们 调用 了 getWindow() .getDecorView() 方 法 拿 到 当前 Activity 的 DecorView ,再 调用 它 
的 SetSystemUiVisibility() 方 法 来 改变 系统 UI 的 显示 ， 这 里 传 入 

View.SYSTEM UI FLAG LAYOUT FULLSCREEN 和 

View.SYSTEM UI FLAG LAYOUT STABLE 就 表示 Activity 的 布局 会 显示 在 状态 栏 上 面 ， 最 后 
调用 一 下 setStatusBarColor() 方 法 将 状态 栏 设置 成 透明 色 ，。 


仅仅 这 些 代码 就 可 以 实现 让 背景 图 和 状态 栏 融 合 到 一 起 的 效果 了 。 不 过 ， 由 于 系统 状态 栏 已 经 
成 为 我 们 布局 的 一 部 分 ， 因 此 会 导致 天 气 界 面 的 布局 整体 向 上 偏 移 了 一 些 ， 这样 头 部 布局 就 显 
得 有 些 太 靠 上 上 了。 当然， 这 个 问题 也 是 非常 好 解决 的 ， 借助 android:fitsSystemWindows 
属性 就 可 以 了 。 修 改 now.xml 中 的 代码 ， 如 下 所 示 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/nowLayout" 
android:layout width="match parent" 
android:layout height="530dp" 
android:orientation="vertical"> 


<FrameLayout 
android:id="@+id/titleLayout" 
android:layout width="match parent" 
android:layout height="70dp" 
android:fitsSystemWindows="true"> 


</FrameLayout> 


</RelativeLayout> 


这 里 给 now.xml 界 面 中 的 头 部 布局 增加 了 android:fitsSystemwWindows 属 性 ,设置 成 true 
就 表示 会 为 系统 状态 栏 留 出 空间 。 现 在 重新 运行 一 下 程序 ， 然 后 重新 搜索 并 选择 “北京 市 ”, 次 
果 如 图 15.26 所 示 。 
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图 15.26 让 背景 图 与 状态 栏 融 合 到 一 起 

怎么 样 ? 有 没有 觉得 整个 界面 的 视觉 体验 完全 不 一 样 了 ,瞬间 提升 了 好 几 个 档次 。 

15.5.3 ”记录 选中 的 城市 

虽说 现在 我 们 已 经 成 功 实现 了 显示 天 气 信息 的 功能 ， 可 是 你 应 该 也 已 经 发 现 了 ， 目 前 是 完全 没 
有 对 选中 的 城市 进行 记录 的 。 也 就 是 说 ， 每 当 你 退出 并 重新 进入 程序 之 后 ， 都 需要 再 重新 搜索 
并 选择 一 次 城市 ， 这 显然 是 不 可 接受 的 。 因 此 ,本 小 节 中 我 们 就 来 实现 一 下 记录 选中 城市 的 功 


台 叱 
Bet。 


很 明显 这 个 功能 需要 用 到 持久 化 技术 ， 不 过 由 于 要 存储 的 数据 并 不 属于 关系 型 数据 ,因此 也 用 
不 着 使 用 数据 库存 储 技术 ， 直接 使 用 SharedPreferences 存 储 就 可 以 了 。 


然而 ,即使 是 使 用 SharedPreferences 存 储 这 种 简单 的 操作 ， 我们 这 里 也 要 尽量 按照 MVVM 的 
分 层 架 构 设 计 来 实现 ， 不 要 为 了 图 省 事 就 把 所 有 逻辑 都 写 到 UI 控 制 层 里 面 。 


那么 ,首先 在 logic/dao 包 下 新 建 一 个 PLaceDao 单 例 类 ， 并 编写 如 下 代码 : 
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object PLaceDao { 


fun savePlace(place: Place) { 
sharedPreferences().edit { 
putString("place", Gson().toJson(place)) 
} 


fun getSavedPlace(): Place { 
val placeJson = sharedPreferences().getString("place", "") 
return Gson().fromJjson(placeJson, Place::class.java) 


fun isPlaceSaved() = sharedPreferences().contains("place") 


private fun sharedPreferences() = SunnyWeatherApplication.context. 
getSharedPreferences("sunny weather", Context.MODE PRIVATE) 


} 
在 PLaceDao 类 中 ， 我 们 封装 了 几 个 必要 的 存储 和 读 取 数据 的 接口 。savePlace() 方 法 用 于 将 


PLace 对 象 存 储 到 SharedPreferences 文 件 中 ,这 里 使 用 了 一 个 技巧 ， 我 们 先 通过 GSON 将 
PLace 对 象 转 成 一 个 JSON 字 符 串 ， 然 后 就 可 以 用 字符 串 存 储 的 方式 来 保存 数据 了 。 


读 取 则 是 相反 的 过 程 , 在 getSavedPLace() 方 法 中 ， 我 们 先 将 JSON 字 符 串 从 
SharedPreferences 文 件 中 读 取 出 来 ， 然 后 再 通过 GSON 将 JSON 字 符 串 解析 成 PLace 对 象 并 返 
回 。 


另外 ,这 里 还 提供 了 一 个 isPLaceSaved () 方 法 ， 用 于 判断 是 否 有 数据 已 被 存储 。 


将 PlaceDao 封 装 好 了 之 后 ， 接 下 来 我 们 就 可 以 在 仓库 层 进 行 实现 了 。 修 改 Repository 中 的 代 
码 ,如 下 所 示 : 


object Repository { 
fun savePlace(place: Place) = PlaceDao.savePlace(place) 
fun getSavedPlace() = PlaceDao.getSavedPlace() 


fun isPlaceSaved() = PlaceDao.isPlaceSaved() 


} 


很 简单 ， 仓 库 层 只 是 做 了 一 层 接口 封装 而 已 。 其 实 这 里 的 实现 方式 并 不 标准 ， 因 为 即使 是 对 
SharedPreferences 文 件 进行 读 写 的 操作 ， 也 是 不 太 建议 在 主线 程 中 进行 ， 虽然 它 的 执行 速度 
通常 会 很 快 。 最 佳 的 实现 方式 肯定 还 是 开启 一 个 线程 来 执行 这 些 比较 耗 时 的 任务 ， 然 后 通过 
LiveData 对 象 进行 数据 返回 ， 不 过 这 里 为 了 让 代码 看 起 来 更 加 简单 一 些 ， 我 就 不 使 用 那么 标准 
的 写法 了 。 


这 几 个 接口 的 业务 逻辑 是 和 PlaceViewModel 相 关 的 ， 因 此 我 们 还 得 在 PlaceViewModel 中 再 
进行 一 层 封装 才 行 ， 代 码 如 下 所 示 : 


class PlaceViewModel : ViewModel() { 


fun savePlace(place: Place) = Repository.savePlace(place) 
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fun getSavedPlace() = Repository.getSavedPlace() 


fun isPlaceSaved() = Repository.isPLaceSaved () 


由 于 仓库 层 中 这 几 个 接口 的 内 部 没有 开局 线程 ， 因 此 也 不 必 借 助 LiveData 对 象 来 观察 数据 变 
化 , 直接 调用 仓库 层 中 相应 的 接口 并 返回 即 可 。 


将 存储 与 读 取 PLace 对 象 的 能 力 都 提供 好 了 之 后 ， 接 下 来 就 可 以 进行 具体 的 功能 实现 了 。 首 先 
修改 PlaceAdapter 中 的 代码 ， 如 下 所 示 : 


class PLaceAdapter(private val fragment: PLaceFragment，private val placelist: 
List<Place>) : RecyclerView.Adapter<PlaceAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context).inflate(R.Tlayout.place item， 
parent, false) 
val holder = ViewHolder(view) 
holder.itemView.setOnClickListener { 
val position = holder.adapterPosition 
val place = placeList[position] 
val intent = Intent(parent.context, WeatherActivity::class.java).apply { 
putExtra("location lng", place.Tlocation.lng) 
putExtra("location lat", place.location.lat) 
putExtra("place name", place.name) 
} 
fragment .viewModel .savePlace(place) 
fragment.startActivity(intent) 
fragment .activity?.finish() 


return holder 


这 里 需要 进行 两 处 修改 : 先 把 PLaceAdapter 主 构造 函数 中 传 入 的 Fragment 对 象 改 成 
PLaceFragment 对 象 ， 这样 我 们 就 可 以 调用 PLaceFragment 所 对 应 的 PlaceViewModel 了 ; 
接着 在 onCreateViewHoLder () 方 法 中 ， 当 点 击 了 任何 子 项 布局 时 ， 在 跳 转 到 
WeatherActivity 之 前 ， 先 调用 PlaceViewModel 的 savePLace ( ) 方 法 来 存储 选中 的 城市 。 


完成 了 存储 功能 之 后 ， 我们 还 要 对 存储 的 状态 进行 判断 和 读 取 才 行 ， 修 改 PlaceFragment 中 的 
代码 ,如 下 所 示 : 


class PlaceFragment : Fragment() { 


override fun onActivityCreated(savedInstanceState: Bundle?) { 
super.onActivityCreated(savedInstanceState) 
if (viewModel.isPlaceSaved()) { 
val place = viewModel .getSavedPlace() 
val intent = Intent(context, WeatherActivity::class.java).apply { 
putExtra("location lng", place.location.lng) 
putExtra("location lat", place.location.lat) 
putExtra("place name", place.name) 


startActivity(intent) 
activity?.finish() 
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return 


} 


这 里 在 PlaceFragment 中 进行 了 判断 ， 如 果 当 前 已 有 存储 的 城市 数据 ， 那 么 就 获取 已 存储 的 数 
据 并 解析 成 PLace 对 象 ， 然 后 使 用 它 的 经 纬度 坐标 和 城市 名 直接 跳 转 并 传递 给 
WeatherActivity ,这 样 用 户 就 不 需要 每 次 都 重新 搜索 并 选择 城市 了 。 


现在 重新 运行 一 下 程序 ， 再 次 搜索 并 选择 “北京 市 ”, 然后 退出 程序 ,下 次 进入 程序 的 时 候 会 直 
接 跳 转 到 天 气 界 面 ， 并 且 显 示 最 新 的 天 气 信息 。 


OK , 这 样 第 二 阶段 的 开发 工作 也 都 完成 了 ， 我 们 把 代码 提交 一 下 。 


git add . 
git commit -m "加 入 显示 天 气 信息 的 功能 。" 
git push origin master 
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15.6 手动 刷新 天 气 和 切换 城市 


经 过 两 个 阶段 的 开发 ， 现 在 SunnyWeather 的 主体 功能 已 经 有 了 “， 不 过 你 会 发 现 目 前 存在 着 一 
个 比较 严重 的 bug， 就 是 当 你 选中 了 某 一 个 城市 之 后 ， 就 没 法 再 去 查看 其 他 城市 的 天 气 了 ， 即使 
退出 程序 ,下 次 进来 的 时 候 还 会 直接 跳 转 到 天 气 界 面 。 

因此 ,在 第 三 阶段 中 我 们 要 加 入 切换 城市 的 功能 ， 并 且 为 了 能 够 实时 获取 最 新 的 天 气 ， 还 会 加 
入 于 动 刷 新 天 气 的 功能 。 


15.6.1 手动 刷新 天 气 


由 于 界面 上 显示 的 天 气 信息 有 可 能 会 过 期 ， 因 此 用 户 需要 一 种 方式 来 手动 刷新 天 气 。 那 么 具体 
应 该 如 何 触发 刷新 事件 呢 ? 这 里 我 准备 采用 下 拉 刷 新 的 方式 ， 正 好 我 们 之 前 学 过 下 拉 刷 新 控件 
的 用 法 ， 实 现 起 来 会 比较 简单 。 


首先 修改 activity weatherxml 中 的 代码 ， 如 下 所 示 : 


<androidx.swiperefreshlayout.widget.SwipeRefreshLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/swipeRefresh" 
android:layout width="match parent" 
android:layout height="match parent"> 


<ScrollView 
android:id="@+id/weatherLayout" 
android:layout width="match parent" 
android:layout height="match parent" 
android:overScrollMode="never" 
android:scrollbars="none" 
android:visibility="invisible"> 


</ScrollView> 


</androidx.swiperefreshlayout.widget.SwipeRefreshLayout> 


可 以 看 到 ， 这 里 在 ScrollView 的 外 面 诅 套 了 一 层 SwipeRefreshLayout , 这 样 ScrollView 就 自 
动 拥 有 下 拉 刷 新 功能 了 。 


然后 修改 WeatherActivity 中 的 代码 ， 加 入 刷新 天 气 的 处 理 逻 辑 ， 如 下 所 示 : 


class WeatherActivity : AppCompatActivity() { 
val viewModel by lazy { ViewModelProvider(this).get(WeatherViewModel::class.java) } 
override fun onCreate(savedInstanceState: Bundle?) { 


viewModel .weatherLiveData.observe(this, Observer { result -> 
val weather = result.getOrNull() 
if (weather != null) { 
showWeatherInfo (weather) 
} else { 
Toast .makeText (this，“" 无 法 成 功 获取 天 气 信息 "，Toast .LENGTH_SHORT). show() 
result.exceptionOrNull()?.printStackTrace() 
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swipeRefresh.isRefreshing = false 
}) 
swipeRefresh.setColorSchemeResources(R.color.colorPrimary) 
refreshWeather() 
swipeRefresh.setOnRefreshListener { 

refreshWeather() 
} 


fun refreshweather() { 
viewModel.refreshWeather(viewModel.\locationLng, viewModel.locationLat) 
swipeRefresh.isRefreshing = true 


修改 的 代码 并 不 算 多 ， 首先 我 们 将 之 前 用 于 刷新 天 气 信 息 的 代码 提取 到 了 一 个 新 的 
refreshWeather() 方 法 中 ， 在 这 里 调用 WeatherViewModel 的 refreshWeather() 方 法 ， 
并 将 SwipeRefreshLayout 的 isRefreshing 属 性 设置 成 true ,从 而 让 下 拉 刷 新 进度 条 显示 出 
来 。 然 后 在 onCreate ( ) 方 法 中 调用 了 SwipeRefreshLayout 的 
setCoLorSchemeResources () 方 法 ， 来 设置 下 拉 刷 新 进度 条 的 颜色 ， 我 们 就 使 用 
colors.xml 中 的 cotorPrimary 作 为 进度 条 的 颜色 了 。 接 着 调用 Set0nRef reshListener() 
方法 给 SwipeRefreshLayout 设 置 一 个 下 拉 刷 新 的 监听 器 ， 当 触发 了 下 拉 刷 新 操作 的 时 候 ， 就 
在 监听 器 的 回调 中 调用 refreshweather( ) 方 法 来 刷新 天 气 信息 。 


另外 不 要 忘记 , 当 请 求 结 束 后 ， 还 需要 将 SwipeRefreshLayout 的 isRefreshing 属 性 设置 成 
faLse， 用 于 表示 刷新 事件 结束 ， 并 隐藏 刷新 进度 条 。 


现在 重新 运行 一 下 程序 , 并 在 屏幕 的 主 界面 向 下 拖 动 ， 刷 新 进度 条 就 会 显示 出 来 了 ， 效 果 如 图 
15.27 所 示 。 
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图 15.27 ”手动 刷新 天 气 

天 气 刷 新 完成 之 后 ,下拉 进度 条 会 自动 消失 。 

15.6.2 切换 城市 

完成 了 手动 刷新 天 气 的 功能 ， 接 下 来 我 们 继续 实现 切换 城市 功能 。 


既然 是 要 切换 城市 ， 那 么 就 肯定 需要 搜索 全 球 城 市 的 数据 ， 而 这 个 功能 我 们 早 在 15.4 节 就 已 经 
完成 了 ， 并 且 为 了 方便 后 面 的 复 用 ， 当 时 特意 选择 了 在 Fragment 中 实现 。 因 此 ,我 们 其 实 只 需 
要 在 天 气 界 面 的 布局 中 引入 这 个 Fragment , 就 可 以 快速 集成 切换 城市 功能 了 。 


虽说 实现 原理 很 简单 ， 但 是 显然 我 们 也 不 可 能 让 引入 的 Fragment 把 天 气 界面 遮挡 住 ， 这 又 该 怎 
么 办 呢 ? 还 记得 12.3 节 学 过 的 滑动 菜单 功能 吗 ? 将 Fragment 放 入 滑动 菜单 中 实在 是 再 合适 不 
过 了 ， 正 常情 况 下 它 不 占据 主 界面 的 任何 空间 ， 想 要 切换 城市 的 时 候 ， 只 需要 通过 滑动 的 方式 
将 菜单 显示 出 来 就 可 以 了 。 

下 面 我 们 就 按照 这 种 思路 来 实现 。 首 先 按照 Material Design 的 建议 ， 我 们 需要 在 头 布局 中 加 入 
一 个 切换 城市 的 按钮 ， 不 然 的 话 用 户 可 能 根本 就 不 知道 屏幕 的 左 侧 边缘 是 可 以 拖 动 的 。 修 改 
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now.xml 中 的 代码 ,如 下 所 示 : 


android:id="@+id/nowLayout" 
android:layout width="match parent" 
android:layout height="530dp" 
android:orientation="vertical"> 


<FrameLayout 
android:id="@+id/titleLayout" 
android:layout width="match parent" 
android:layout height="70dp" 
android:fitsSystemWindows="true"> 


<Button 
android:id="@+id/navBtn" 
android:layout width="30dp" 
android:layout height="30dp" 
android:layout marginStart="15dp" 
android:layout gravity="center vertical" 
android:background="@drawable/ic home" /> 


</FrameLayout> 


</RelativeLayout> 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


这 里 添加 了 一 个 Button 作 为 切换 城市 的 按钮 ， 并 且 让 它 居 左 显示 。 


接着 修改 activity_weatherxml 布 局 来 加 入 滑动 菜单 功能 ， 如 下 所 示 : 


<androidx,.drawerLayout .widget.DrawerLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="@+id/drawerLayout" 
android:layout width="match parent" 
android:layout height="match parent"> 


<androidx.swiperefreshlayout.widget.SwipeRefreshLayout 
android:id="@+id/swipeRefresh" 
android:layout width="match parent" 
android:layout height="match parent"> 


</androidx.swiperefreshlayout ,widget.SwipeRefreshLayout> 


<FrameLayout 
android:layout width="match parent" 
android:layout height="match parent" 
android:layout gravity="start" 
android:clickable="true" 
android:focusable="true" 
android:background="@color/colorPrimary"> 


<fragment 
android:id="@+id/placeFragment" 


android:layout width="match parent" 
android:layout height="match parent" 
android:layout marginTop="25dp"/> 


</FrameLayout> 


</androidx.drawerlayout.widget.DrawerLayout> 


android:name="com.sunnyweather.android.ui.place.PlaceFragment" 
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可 以 看 到 ， 我 们 在 SwipeRefreshLayout 的 外 面 又 能 套 了 一 层 DrawerLayout。 
DrawerLayout 中 的 第 一 个 子 控件 用 于 显示 主屏 幕 中 的 内 容 ， 第 二 个 子 控 件 用 于 显示 滑动 菜单 
中 的 内 容 ， 因 此 这 里 我 们 在 第 二 个 子 控件 的 位 置 添加 了 用 于 搜索 全 球 城市 数据 的 Fragment。 另 
外 ， 为 了 让 Fragment 中 的 搜索 框 不 至 于 和 系统 状态 栏 重 合 ， 这 里 特意 使 用 外 层 包 库 布 局 的 方式 
让 它 向 下 偏 移 了 一 段 距离 。 


接 下 来 需要 在 WeatherActivity 中 加 入 滑动 菜单 的 逻辑 处 理 ， 修改 WeatherActivity 中 的 代码 ， 
如 下 所 示 : 


class WeatherActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 


navBtn.setOnClickListener { 
drawerLayout ,openDrawer(GravityCompat ,START) 
} 


drawerLayout.addDrawerListener(object : DrawerLayout.DrawerListener { 
override fun onDrawerStateChanged(newState: Int) {} 


override fun onDrawerSlide(drawerView: View, slide0Offset: Float) {} 
override fun onDrawerOpened(drawerView: View) {} 


override fun onDrawerClosed(drawerView: View) { 
val manager = getSystemService(Context,.INPUT METHOD SERVICE) 
as InputMethodManager 
manager.hideSoftInputFromWindow(drawerView.windowToken, 
InputMethodManager .HIDE NOT ALWAYS) 


} 


这 里 我 们 主要 做 了 两 件 事 : 第 一 ， 在 切换 城市 按钮 的 点 击 事件 中 调用 DrawerLayout 的 
openD rawer( ) 方 法 来 打开 滑动 菜单 ; 第 二 , 监听 DrawerLayout 的 状态 ， 当 滑动 菜单 被 隐藏 
的 时 候 ， 同 时 也 要 隐藏 输入 法 。 之 所 以 要 做 这 样 一步 操 作 ， 是 因为 待 会 我 们 在 滑动 菜单 中 搜索 
城市 时 会 弹出 输入 法 ， 而 如 果 滑 动 菜单 隐藏 后 输入 法 却 还 显示 在 界面 上 ,就 会 是 一 种 非常 怪异 
的 情况 。 


另外 ， 我 们 之 前 在 PlaceFragment 中 做 过 一 个 数据 存储 状态 的 判断 ， 假 如 已 经 有 选中 的 城市 保 
存在 SharedPreferences 文 件 中 了 ， 那 么 就 直接 跳 转 到 WeatherActivity。 但 是 现在 将 
PlaceFragment 散 入 WeatherActivity 中 之 后 ， 如果 还 执行 这 段 逻 辑 肯定 是 不 行 的 ， 因 为 这 会 
造成 无 限 循环 跳 转 的 情况 。 为 此 需要 对 PlaceFragment 进 行 如 下 修改 : 


class PlaceFragment : Fragment() { 


override fun onActivityCreated(savedInstanceState: Bundle?) { 
super.onActivityCreated(savedInstanceState) 
if (activity is MainActivity &A& viewModel.isPlaceSaved()) { 
val place = viewModel .getSavedPlace() 
val intent = Intent(context, WeatherActivity::class.java).apply { 
putExtra("location lng", place.location.lng) 
putExtra("location lat", place.location.lat) 
putExtra("place name", place.name) 
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startActivity(intent) 
activity?.finish() 
return 


这 里 又 多 做 了 一 层 逻 辑 判断 ,只 有 当 PlaceFragment 被 鹏 入 MainActivity 中 ， 并 且 之 前 已 经 存 
在 选中 的 城市 ， 此 时 才 会 直接 跳 转 到 WeatherActivity, 这样 就 可 以 解决 无 限 循环 跳 转 的 问题 
TT 


不 过 现在 还 没有 结束 ， 我 们 还 需要 处 理 切 换 城市 后 的 逻辑 。 这 个 工作 就 必须 在 PlaceAdapter 中 
进行 了 ， 因 为 之 前 选中 了 某 个 城市 后 是 跳 转 到 WeatherActivity 的 ， 而 现在 由 于 我 们 本 来 就 是 
在 WeatherActivity 中 的 ， 因 此 并 不 需要 跳 转 ， 只 要 去 请 求 新 选择 城市 的 天 气 信 息 就 可 以 了 。 


那么 很 显然 ,这 里 同样 需要 根据 PlaceFragment 所 处 的 Activity 来 进行 不 同 的 逻辑 处 理 ， 修 改 
PlaceAdapter 中 的 代码 ， 如 下 所 示 : 


class PLaceAdapter(private val fragment: PLaceFragment，private val placelist: 
List<Place>) : RecyclerView.Adapter<PlaceAdapter.ViewHolder>() { 


override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder { 
val view = LayoutInflater.from(parent.context).inflate(R.Tlayout.place item, 
parent, false) 
val holder = ViewHolder (view) 
holder.itemView.setOnClickListener { 
val position = holder.adapterPosition 
val place = placeList[position] 
val activity = fragment.activity 
if (activity is WeatherActivity) { 
activity.drawerLayout.closeDrawers() 
activity.viewModel.locationLng = place.location.\ng 
activity.viewModel.locationLat = place.location. lat 
activity.viewModel .placeName = place.name 
activity.refreshWeather() 
} else { 
val intent = Intent(parent.context, WeatherActivity::class.java). 
apply { 
putExtra("location lng", place.location.\lng) 
putExtra("location lat", place.location.lat) 
putExtra("place name", place.name) 
} 
fragment.startActivity(intent) 
activity?.finish() 
} 


fragment.viewModel .savePlace(place) 


return holder 


这 PASEragmnentD ten y 了 了 判断 : 如 果 是 在 WeatherActivity 中 ， 那 么 
就 关闭 滑动 菜单 ， 给 WeatherViewModel 赋 值 新 的 经 纬度 坐标 和 地 区 名 称 ， 然 后 刷新 城市 的 天 
气 信息 ; 而 如 果 是 在 MainActivity 中 ， 那么 就 保持 之 前 的 处 理 逻 辑 不 变 即 可 。 
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这 样 我 们 就 把 切换 城市 的 功能 全 部 完成 了 ， 现 在 可 以 重新 运行 一 下 程序 ， 效果 如 图 15.28 所 示 。 


OUak 


睛 | 空气 指数 26 


预报 


2019-10-25 3 多 云 4~13°C 


图 15.28 拥有 切换 城市 按钮 的 天 气 界面 


可 以 看 到 ,标题 栏 上 多 出 了 一 个 用 于 切换 城市 的 按钮 。 点 击 该 按钮 ,或 者 在 屏幕 的 左 侧 边缘 进 
行 拖 动 ， 就 能 让 滑动 菜单 界面 显示 出 来 ， 然 后 我 们 就 可 以 在 这 里 搜索 并 切换 城市 了 ， 如 图 15.29 
所 示 。 
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深圳 市 


深圳 北 站 
让 


深圳 站 
t 国 站 


图 15.29 ”显示 滑动 菜单 界面 


选中 新 的 城市 之 后 滑动 菜单 会 自动 关闭 ， 并 且 主 界面 上 的 天 气 信 息 也 会 更 新 成 你 选择 的 那个 城 
市 。 


这 样 ， 第 三 阶段 的 开发 任务 也 完成 7。 当然， 仍然 不 要 忘记 提交 代码 。 


git add . 
git commit -m "新 增 切换 城市 和 手动 更 新 天 气 的 功能 。" 
git push origin master 
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15.7 制作 App 的 图 标 


目前 的 SunnyWeather 看 起 来 还 不 太 像 是 一 个 正式 的 App， 为 什么 呢 ? 因为 它 还 没有 一 个 像样 
的 图 标 呢 。 一 直 使 用 Android Studio 自 动 生成 的 图 标 确实 不 太 合适 ， 因 此 在 第 四 阶段 ， 我 们 需 
要 制作 一 下 应 用 程序 的 图 标 。 


在 过 去 ,Android 应 用 程序 的 图 标 都 应 该 放 到 相应 分 状 率 的 mipmap 目 录 下 ， 不 过 从 Android 
8.0 系 统 开始 ，Google 已 经 不 再 建议 使 用 单一 的 一 张 图 片 来 作为 应 用 程序 的 图 标 ， 而 是 应 该 使 
用 前 景 和 背景 分 离 的 图 标 设计 方式 。 具 体 来 讲 ， 应 用 程序 的 图 标 应 该 被 分 为 两 层 : 前 景 层 和 背 
景 层 。 前 景 层 用 来 展示 应 用 图 标的 Logo， 背景 层 用 来 衬托 应 用 图 标的 Logo。 需 要 注意 的 是 ， 背 
景 层 在 设计 的 时 候 只 人 允许 定义 颜色 和 纹理 ， 不 能 定义 形状 。 


那么 图 标的 形状 由 谁 来 定义 呢 ? Google 将 这 个 权利 交 给 了 手机 厂商 。 手 机 厂商 会 在 图 标的 前 景 
层 和 背景 层 之 上 再 盖 上 一 层 mask ,这 个 mask 可 以 是 圆 角 和 矩形 、 圆 形 或 者 是 方形 等 ， 视 具体 手 
机 厂商 而 定 ， 这 样 就 可 以 将 手机 上 所 有 应 用 程序 的 图 标 都 裁剪 成 相同 的 形状 ， 从 而 统一 图 标的 
设计 规范 ， 原 理 如 图 15.30 所 示 。 


图 15.30 ”8.0 及 以 上 系统 的 图 标 原理 示意 图 


可 以 看 到 ， 这 里 使 用 的 是 一 种 圆 形 的 mask， 那么 最 终 裁剪 出 的 应 用 程序 图 标 也 会 是 圆 形 的 ， 如 
图 15.31 所 示 。 
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图 15.31 裁剪 后 的 应 用 程序 图 标 


了 解 了 工作 原理 之 后 ， 接 下 来 我 们 就 开始 动手 实现 吧 。 这 里 我 事先 准备 好 了 一 张 图 片 作为 图 标 
的 前 景 层 Logo (图 片 见 SunnyWeather 项 目 源码 的 logo 目 录 ， 源 码 下 载 地址 见 前 言 ， 或 者 也 可 
以 到 SunnyWeather 的 GitHub 主 页 去 下 载 ) 。 由 于 我 不 是 搞 美 术 的 ， 因 此 Logo 设 计 得 很 简 
单 ， 如 图 15.32 所 示 。 


图 15.32 图 标的 前 景 层 Logo 


然后 我 们 可 以 借助 Android Studio 提 供 的 Asset Studio 工 具 来 制作 能 够 兼容 各 个 Android 系 统 
版 本 的 应 用 程序 图 标 。 点 击 导航 栏 中 的 File=-New 瑟 Image Asset 开 Asset Studio 工 具 ,如 
图 15.33 所 示 。 
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@e Asset Studio 


Configure Image Asset 
Android Studio 


Icon Type: Launcher lcons (Adaptive and Legacy) v Preview xhdpi Me Show Safe Zone [| Show Grid 
Name: ic_launcher 
Foreground Layer Background Layer Legacy 
Layer Name: ic_launcher_foreground 


Source Asset 
Asset Type: © Image OO Clip Art OO Text 


Path: able-v24/ic_launcher_foreground.xml 


Scaling 


A An icon with the same name already exists and will be overwritten. 


? Cancel | | prevous | 攻 世 和 Fw 
图 15.33 Asset Studio 的 主 界面 
这 个 Asset Studio 非 常 简单 好 用 ,一 学 就 会 。 左 边 是 操作 区 域 ， 右边 是 预览 区 域 。 


先 来 看 操作 区 域 ， 第 一 行 的 Icon Type 保持 默认 就 可 以 了 ， 表示 同时 创建 兼容 8.0 系 统 以 及 老 版 
本 系统 的 应 用 图 标 。 第 二 行 的 Name 用 于 指定 应 用 图 标的 名 称 ， 这 里 也 保持 ic_Launcher 的 命 
名 即 可 ,这 样 可 以 覆盖 掉 之 前 自动 生成 的 应 用 程序 图 标 。 接 下 来 的 3 个 页 签 ，Foreground 
Layer 用 于 编辑 前 景 层 , Background Layer 用 于 编辑 背景 层 ，Legacy 用 于 编辑 老 版 本 系统 的 
图 标 。 


再 来 看 预览 区 域 ， 这 个 就 更 简单 了 ， 它 的 主要 作用 就 是 预览 应 用 图 标的 最 终 效 果 。 在 预览 区 域 
中 给 出 了 可 能 生成 的 图 标 形状 ， 包 括 圆 形 、 圆 角 算 形 、 方 形 ， 等 等 。 注 意 ,每 个 预览 图 标 中 都 
有 一 个 圆圈 ,这 个 圆圈 叫 作 安 全 区 域 ， 必 须 保证 图 标的 前 景 层 完全 处 于 安全 区 域 中 才 行 ， 否 则 
可 能 会 出 现 应 用 图 标的 Logo 被 手机 厂商 的 mask 裁 剪 掉 的 情况 。 


下 面 我 们 来 具体 操作 一 下 吧 ,在 Foreground Layer 中 选取 之 前 准备 好 的 那 张 Logo 图 片 ， 并 通 
过 下 方 的 Resize 拖 动 条 对 图 片 进 行 缩放 ， 以 保证 前 景 层 的 所 有 内 容 都 是 在 安全 区 域 中 的 。 然 后 
在 Background Layer 中 选择 “Color" 这 种 Asset Type 模 式 ， 并 使 用 #219FDD 这 个 颜色 值 作为 
背景 层 的 颜色 。 最 终 的 预览 效果 如 图 15.34 所 示 。 
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Asset Studio 


Configure Image Asset 


Android Studio 


Icon Type: Launcher Icons (Adaptive and Legacy) vv Preview xhdpi Show Safe Zone [| Show Grid 


Name: ic_launcher 


ForegroundLayer Background Layer Legacy 
Layer Name: ic_launcher_background 


Source Asset 


Asset Type: © Color ( Image Circle Squircle Rounded Square 
cer 
Scaling 

Trim: Yes CI) No 

Resize: A 100% 


Full Bleed Layers Legacy Icon Round Icon Google Play Store 


A An icon with the same name already exists and will be overwritten. 


图 15.34 ”应 用 图 标的 预览 效果 
在 预览 区 域 可 以 看 到 ,现在 我 们 的 图 标 已 经 能 够 应 对 各 种 不 同类 型 的 mask 了 。 
接 下 来 点 击 “Next” 会 进入 一 个 确认 图 标 生 成 路 径 的 界面 ， 然 后 直接 点 击 界面 上 的 “Finish” 按 钮 


就 可 以 完成 图 标的 制作 了 。 所 有 图 标 相关 的 文件 都 会 被 生成 到 相应 分 辨 率 的 mipmap 目 录 下 ， 
如 图 15.35 所 示 。 
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mipmap-anydpi-v26 

ma iCc_launcher.xml 

局 1 ic_launcher_round.xml 
mipmap-hdpi 

下 ic_launcher.png 

a ic_launcher_foreground.png 
3 ic_launcher_round.png 
mipmap-mdpi 

当 ic_launcher.png 

| ic_launcher_ foreground.png 
3 ic_launcher_round.png 
mipmap-xhdpi 

下 ic_launcher.png 

当 ic_launcher_foreground.png 
a ic_launcher_round.png 
mipmap-xxhdpi 

a ic_launcher.png 

a ic_launcher_foreground.png 
下 ic_launcher_round.png 
mipmap-xxxhdpi 
ic_launcher.png 

a ic_launcher_foreground.png 
| ic_launcher_round.png 


图 15.35 ” mipmap 目录 下 的 文件 


但 是 , 其 中 有 一 个 mipmap-anydpi-v26 目 录 中 放 的 并 不 是 图 片 ,而 是 xml 文 件 , 这 是 什么 意思 
呢 ? 其实 只 要 是 Android 8.0 及 以 上 系统 的 手机 ， 都 会 使 用 这 个 目录 下 的 文件 来 作为 图 标 。 我 们 
可 以 打开 ic_launcher.xm|I 文 件 来 查看 它 的 代码 : 


<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android"> 
<background android:drawable="@color/ic launcher background"/> 
<foreground android:drawable="@mipmap/ic launcher foreground"/> 
</adaptive-icon> 


这 就 是 适 配 Android 8.0 及 以 上 系统 应 用 图 标的 标准 写法 。 可 以 看 到 ,这 里 在 <adaptive- 
icon> 标 签 中 定义 了 一 个 <background> 标 签 用 于 指定 图 标的 背景 层 ,引用 的 是 我 们 之 前 设置 
的 颜色 值 。 又 定义 一 个 <foreground> 标 签 用 于 指定 图 标的 前 景 层 ,引用 的 就 是 我 们 之 前 准备 
的 那 张 Logo 图 片 。 


那么 这 个 ic_launcher.xm|I 文 件 又 是 在 哪里 被 引用 的 呢 ? 其 实 只 要 打开 一 下 
AndroidManifest.xml 文 件 , 所 有 的 秘密 就 被 解 开 了 ， 代 码 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.sunnyweather.android"> 


<application 
android:name=" .SunnyWeatherApplication" 
android:allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android:label="@string/app_name" 
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android:roundIcon="@mipmap/ic _ Launcher_round " 
android:supportsRtl="true" 
android:theme="@style/AppTheme"> 


</application> 
</manifest> 


可 以 看 到 , <appLication> 标 签 的 android:icon 属 性 就 是 专门 用 于 指定 应 用 程序 图 标的 ， 
这 里 将 图 标 指定 成 了 Gmipmap/ic_Launcher , 那么 在 Android 8.0 及 以 上 系统 中 ， 就 会 使 用 
mipmap-anydpi-v26 目 录 下 的 ic_launcher.xmI 文 件 来 作为 应 用 图 标 。7.0 及 以 下 系统 就 会 使 
用 mipmap 相 应 分 辨 率 目录 下 的 ic_launcher.png 图 片 来 作为 应 用 图 标 。 另 外 你 可 能 注意 到 了 ， 
<appLication> 标 签 中 还 有 一 个 android: roundIcon 属 性 , 这 是 一 个 只 适用 于 Android 7.1 
系统 的 过 渡 版 本 ， 很 快 就 被 8.0 系 统 的 新 图 标 适 配方 案 所 奉 代 了 ， 我们 可 以 不 必 关 心 已 。 这 样 
SunnyWeather 的 图 标 就 制作 完成 了 ， 现 在 重新 运行 一 下 程序 ， 并 观察 桌面 应 用 ， 效果 如 图 


15.36 所 示 。 
ga 


Chrome playStoreqSsunnyWe® 


图 15.36 ”手机 桌面 的 图 标 


可 以 看 到 ，SunnyWeather 的 图 标 在 Pixel 模 拟 器 上 被 裁剪 成 了 圆 形 ， 和 其 他 应 用 图 标的 形状 是 
保持 一 致 的 。 而 如 果 你 在 别 的 手机 上 运行 ， 得 到 的 可 能 会 是 不 同 的 效果 。 


另外 ， 在 Pixel 模 拟 器 上 , 由 于 SunnyWeather 这 个 名 字 太 长 了 ， 因此 应 用 名 没 能 得 到 完整 的 显 
示 。 如 果 你 想 要 将 它 修改 成 短 一 点 的 名 字 , 打开 res/values/string.xml 文 件 ， 并 编辑 如 下 部 分 
内 容 即 可 : 


<resources> 
<string name="app_name">SunnyWeather</string> 
</resources> 


最 后 ， 养 成 良好 的 习惯 ， 仍 然 不 要 忘记 提交 代码 。 


git add . 
git commit -m "修改 App 的 图 标 。" 
git push origin master 


这 样 我 们 就 终于 大 功 告 成 了 ! 
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15.8 生成 正式 签名 的 APK 文 件 


之 前 我 们 一 直 都 是 通过 Android Studio 来 将 程序 安装 到 手机 上 的 ， 而 它 背 后 实际 的 工作 流程 
是 ,Android Studio 会 将 程序 代码 打包 成 一 个 APK 文 件 ， 然 后 将 这 个 文件 传输 到 手机 上 ， 最 后 
再 执行 安装 操作 。Android 系 统 会 将 所 有 的 APK 文 件 识 别 为 应 用 程序 的 安装 包 ，, 类似 于 
Windows 系 统 上 的 EXE 文 件 。 


但 并 不 是 所 有 的 APK 文 件 都 能 成 功 安装 到 手机 上 ,Android 系统 要 求 只 有 签名 后 的 APK 文 件 才 可 
以 安装 ， 因 此 我 们 还 需要 对 生成 的 APK 文 件 进行 签名 才 行 。 那 么 你 可 能 会 有 疑问 了 ， 直接 通过 
Android Studio 运 行程 序 的 时 候 好 像 并 没有 进行 过 签名 操作 啊 ， 为 什么 还 能 将 程序 安装 到 手机 
上 呢 ? 这 是 因为 Android Studio 使 用 了 一 个 默认 的 keystore 文 件 帮 我 们 自动 进行 了 签名 。 点 击 
Android Studio 右 侧 工具 栏 的 Gradle=» 项 目 名 app 一 Tasks=android , 双 
击 “signingReport”, 结果 如 图 15.37 所 示 。 

> Task :app:signingReport 

Variant: debugUnitTest 

Config: debug 


Store: /Users/guolin/.android/debug.keystore 
ALias: AndroidDebugKey 


图 15.37 查看 默认 的 keystore 文 件 


也 就 是 说 ， 我们 所 有 通过 Android Studio 来 运行 的 程序 都 是 使 用 这 个 debug.keystore 文 件 来 
进行 签名 的 。 不 过 这 仅仅 适用 于 开发 阶段 而 已 ， 如 果 要 正式 发 布 应 用 程序 的 话 ， 要 使 用 一 个 正 
式 的 keystore 文 件 来 进行 签名 才 行 。 下 面 我 们 就 来 学 习 一 下 ， 如 何 生成 一 个 带 有 正式 签名 的 
APK 文 件 。 


15.8.1 使 用 Android Studio 生 成 


先 学 习 一 下 如 何 使 用 Android Studio 来 生成 正式 签名 的 APK 文 件 。 点 击 Android Studio 导 航 栏 
上 的 BuildGenerate Signed Bundle / APK , 会 弹出 如 图 15.38 所 示 的 对 话 框 。 
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仿 过 Generate Signed Bundle or APK 


© AndroidApp Bundle 


Generate a signed app bundle for upload to app stores for the following benefits: 


® Smaller download size 
® On-demand app features 
® Asset-only modules 


Learn more 


Build a signed APK that you can deploy to a device 


图 15.38 生成 Bundle 或 APK 的 对 话 框 


这 里 让 我 们 选择 是 创建 Android App Bundle 文 件 ， 还 是 创建 APK 文 件 。 其 中 , Android App 
Bundle 文 件 是 用 于 上 架 Google Play 商店 的 ， 使 用 这 种 类 型 的 文件 , Google Play 可 以 根据 用 
户 的 手机 ,只 下 发 它 需要 的 那 部 分 程序 资源 。 比 如 说 一 个 高 分 辩 率 的 手机 ， 是 没有 必要 下 载 低 

分 辩 率 目录 下 的 图 片 资源 的 ; 一 个 arm 架 构 的 手机 ， 也 没有 必要 下 载 X86 架 构 下 的 so 文件 (so 

文件 是 使 用 C/C+ 二 代码 开发 的 库 文 件 ， 不 在 我 们 本 书 讨论 范围 内 ) 。 因 此 ， 使 用 Android App 
Bundle 文 件 可 以 显著 地 减少 App 的 下 载体 积 ， 但 缺点 是 它 不 能 直接 安装 到 手机 上 ， 也 不 能 用 于 
上 架 除 Google Play 之 外 的 其 他 应 用 商店 。 


不 管 你 选择 创建 的 是 Android App Bundle 文 件 还 是 APK 文 件 ， 后 面 的 流程 基本 上 是 一 样 的 ， 
此 我 还 是 以 创建 APK 文 件 来 举例 。 点 击 “Next" 后 会 要 求 我 们 填 入 keystore 文 件 的 路 径 和 密码 ， 
如 图 15.39 所 示 。 
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@° @ Generate Signed Bundle or APK 


Module 


Key store path | 
Create new... Choose existing... 

Key store password 

Key alias 

Key password 


_ | Remember passwords 


2 Cancel 


Previous | Next | 
图 15.39 ”生成 Bundle 或 APK 的 对 话 框 


由 于 目前 我 们 还 没有 一 个 正式 的 keystore 文 件 ， 所 以 应 该 点 击 “Create new” 按 钮 ， 然 后 会 弹 
出 一 个 新 的 对 话 框 来 让 我 们 填写 创建 keystore 文 件 所 必要 的 信息 。 根 据 自己 的 实际 情况 进行 填 
写 就 行 了 ， 如 图 15.40 所 示 。 
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@  @ New Key Store 


Key store path: /Users/guolin/guolin.jks 


Password: seeesee Confirm: eeveeee 
Key 

Alias: guolindev 

Password: seee00e Confirm: ee000e0 


入 


Validity (years): 50 3 


Certificate 


First and Last Name: Lin Guo 


Organizational Unit: “Personal 


Organization: Lin Guo 
City or Locality: Suzhou 
State or Province: Jiangsu 


Country Code (XX): 86 


图 15.40 填写 keystore 文 件 信息 


这 里 需要 注意 ,在 Validity 那 一 栏 填写 的 是 keystore 文 件 的 有 效 时 长 ， 单 位 是 年 ， 建 议 时 间 可 
以 填 得 长 一 些 ， 比 如 我 填 了 50 年 。 然 后 点 击 “OK"”, 这 时 我 们 刚才 填写 的 信息 会 自动 填充 到 创建 
签名 APK 的 对 话 框 中 ， 如 图 15.41 所 示 。 
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人 @ Generate Signed Bundle or APK 


Module 
Key store path /Users/guolin/guolin.jks 
Create new... Choose existing... 
Key store password  。。。。。。。 
Key alias guolindev 
Key password eeeees 


| | Remember passwords 


2 Cancel Previous | Next | 


图 15.41 信息 自动 填充 完整 


如 果 你 希望 以 后 都 不 用 再 输 keystore 的 密码 了 ， 可 以 将 “Remember passwords" 选 项 勾 上 。 
然后 点 击 “Next”, 这 时 就 要 选择 APK 文 件 的 输出 地 址 了 ， 如 图 15.42 所 示 。 


© ® Generate Signed Bundle or APK 


Destination Folder: /AndroidStudioProjects/AndroidFirstLine/SunnyWeather/app 


debug 


release 


Build Variants: 


Signature Versions: V1 (Jar Signature) 网 V2 (Full APK Signature) Signature Help 


入 Cancel Previous 


图 15.42 信息 自动 填充 完整 


这 里 默认 是 将 APK 文 件 生成 到 项 目的 app 目 录 下 ， 我 就 不 做 修改 了 。 至 于 构建 类 型 选 
择 “release”, 因为 我 们 这 是 要 出 正式 版 的 APK 文 件 ， 不 能 再 使 用 debug 类 型 了 。 另 外 ， 注意 一 
定 要 将 签名 版 本 中 的 V1 和 V2 选项 同时 多 上 ， 表示 会 使 用 同时 兼容 新 老 版 本 系统 的 签名 方式 。 
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现在 点 击 “Finish”, 然后 稍 等 一 段 时 间 ，APK 文 件 就 会 生成 好 了 “， 并 且 会 在 右 下 角 弹 出 一 个 如 
图 15.43 所 示 的 提示 。 


9 Generate Signed APK 
APK(s) generated successfully for module 'app' 
with 1 build variant: 
Build variant "release': locate or analyze the APK. 


图 15.43 提示 APK 文 件 生成 成 功 
我 们 点 击 提 示 上 的 “locate”, 可 以 立刻 查看 生成 的 APK 文 件 ， 如 图 15.44 所 示 。 


名 称 人 ”修改 日 期 大 小 种 类 
app-release.apk 下 午 1:12 4.9 MB ”文稿 
output.json 下 午 1:12 234 字 节 纯 文 本 文稿 


图 15.44 查看 生成 的 APK 文 件 


这 里 的 app-release.apk 就 是 带 有 正式 签名 的 APK 文 件 了 ， 它 可 以 直接 安装 到 手机 上 , 也 可 以 
用 于 上 架 到 各 个 应 用 商店 中 。 而 如 果 前 面 我 们 选择 了 创建 Android App Bundle 文 件 , 这 里 将 
会 得 到 一 个 .aab 后 缀 的 签名 文件 ,这 是 Google Play 商 店 现在 更 加 推荐 使 用 的 文件 格式 。 


15.8.2 使 用 Gradle 生 成 


上 一 小 节 中 我 们 使 用 了 Android Studio 提 供 的 可 视 化 工具 来 生成 带 有 正式 签名 的 APK 文 件 ， 除 
此 之 外 , Android Studio 其 实 还 提供 了 另外 一 种 方式 一 一 使 用 Gradle 生 成 。 下 面 我 们 就 来 学 习 
二 下 


Gradle 是 一 个 非常 先进 的 项 目 构建 工具 ， 在 Android Studio 中 开发 的 所 有 项 目 都 是 使 用 它 来 
构建 的 。 在 之 前 的 项 目 中 ， 我 们 也 体验 过 了 Gradle 带 来 的 很 多 便利 之 处 ， 比 如 说 当 需 要 添加 依 
赖 库 的 时 候 ，, 不 需要 自己 再 去 手动 下 载 ， 而 是 直接 在 dependencies 中 添加 一 名 引用 声明 就 可 
以 了 。 


下 面 我 们 开始 学 习 如 何 使 用 Gradle 来 生成 带 有 正式 签名 的 APK 文 件 。 编 辑 app/build.gradle 文 
件 ,在 android 闭 包 中 添加 如 下 内 容 : 


android { 

compileSdkVersion 29 

defaultConfig { 
appLicationId "com.sunnyweather.android" 
minSdkVersion 21 
targetSdkVersion 29 
versionCode 1 
versionName "1.0" 
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" 


signingConfigs { 
config { 
storeFile file('/Users/guolin/guolin.jks') 
storePassword '1234567' 
keyAlias = 'guolindev' 


www.blogss.cn 


keyPassword '1234567 


} 
buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 
'proguard-rules.pro' 


} 


} 


} 


可 以 看 到 ， 这 里 在 android 闭 包 中 添加 了 一 个 signingConfigs 闭 包 ，, 然后 在 
signingConfigs 闭 包 中 又 添加 了 一 个 config 闭 包 。 接 着 在 config 闭 包 中 配置 keystore 文 件 
的 各 种 信息 ，storeFiLe 用 于 指定 keystore 文 件 的 位 置 , storePassword 用 于 指定 密码 ， 
keyALias 用 于 指定 别名 ，keyPassword 用 于 指定 别名 密码 。 


将 签名 信息 都 配置 好 了 之 后 ， 接 下 来 只 需要 在 生成 正式 版 APK 的 时 候 去 应 用 这 个 配置 就 可 以 
了 。 继 续 编辑 app/build.gradle 文 件 , 如 下 所 示 : 


android { 


buildTypes { 
release { 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 
'proguard-rules.pro' 
signingConfig signingConfigs.config 


} 


} 


这 里 我 们 在 buildTypes 下 面 的 release 闭 包 中 应 用 了 刚才 添加 的 签名 配置 ， 这样 当 生 成 正式 
版 APK 文 件 的 时 候 ， 就 会 自动 使 用 我 们 刚才 配置 的 签名 信息 来 进行 签名 了 。 


现在 build.gradle 文 件 已 经 配置 完成 ， 那 么 我 们 如 何 才能 生成 APK 文 件 呢 ? 其 实 非常 简单 ， 
Android Studio 中 内 置 了 很 多 的 Gradle Tasks , 其 中 就 包括 了 生成 APK 文 件 的 Task。 点 击 右 侧 
工具 栏 的 Gradle-= 项 目 名 app 一 Tasks 一 build ,如 图 15.45 所 示 。 


SunnyWeather 
SunnyWeather (root) 
app 
3 Tasks 
3 android 
3 build 
assemble 
assembleAndroidTest 
build 
buildDependents 
buildNeeded 
bundle 
clean 
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图 15.45 查看 内 置 Gradle Tasks 


其 中 , assemble 就 是 用 于 生成 APK 文 件 的 , 它 会 同时 生成 debug 和 release 两 个 版 本 的 APK 文 
件 ， 只 需要 双击 即 可 执行 这 个 Task， 结 果 如 图 15.46 所 示 。 


BUILD SUCCESSFUL in 8s 
53 actionable tasks: 7 executed, 46 up-to-date 
21:28:08: Task execution finished 'assemble'. 


图 15.46 assemble 执 行 成 功 


可 以 看 到 ， 这 里 提示 我 们 "BUILD SUCCESSFUL”，, 说 明 assemble 执 行 成 功 了 。APK 文 件 会 自 
动 生成 在 app/build/outputs/apk 目 录 下 ， 如 图 15.47 所 示 。 


本 SunnyWeather 
Ml .gradle 
.idea 
3 app 
RD build 
Ml generated 
MM intermediates 
Ml kotlin 
MN outputs 
MM apk 
Ml debug 
2 app-debug.apk 
0} oUtput.json 
Ml release 
也 app-release.apk 
@ output.json 


图 15.47 查看 生成 的 APK 文 件 
其 中 ，release 有 目录 下 的 app-release.apk 就 是 带 有 正式 签名 的 APK 文 件 了 。 


虽说 现在 APK 文 件 已 经 成 功 生成 了 ， 不 过 还 有 一 个 小 细节 需要 注意 一 下 。 目 前 keystore 文 件 的 
所 有 信息 都 是 以 明文 的 形式 直接 配置 在 build.gradle 中 的 ， 这 种 做 法 会 不 安全 。 尤 其 是 
SunnyWeather 的 代码 还 是 开源 的 ， 这 样 就 相当 于 把 keystore 文 件 的 密码 公布 出 去 了 。 比 较 推 
荐 的 做 法 是 将 这 类 人 敏感 数据 配置 在 一 个 独立 的 文件 里 面 ， 然 后 再 在 build.gradle 中 去 读 取 这 些 
数据 。 


下 面 我 们 来 按照 这 种 方式 实现 。Android Studio 项 目的 根 目录 下 有 一 个 gradle.properties 文 
件 , 它 是 专门 用 来 配置 全 局 键 值 对 数据 的 。 我 们 在 gradle.properties 文 件 中 添加 如 下 内 容 : 


KEY_PATH=/Users/guolin/guolin.jks 
KEY PASS=1234567 
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ALIAS_NAME=guoLindev 
ALIAS PASS=1234567 


可 以 看 到 ， 这 里 将 keystore 文 件 的 各 种 信息 以 键 值 对 的 形式 进行 了 配置 ， 然 后 我 们 在 
build.gradle 中 去 读 取 这 些 数 据 就 可 以 了 。 编 辑 app/build.gradle 文 件 ,如 下 所 示 : 


android { 


signingConfigs { 
config { 
storeFile file(KEY PATH) 
storePassword KEY_PASS 
keyAlias ALIAS NAME 
keyPassword ALIAS PASS 
} 
} 


} 


这 里 只 需要 将 原来 的 明文 配置 改 成 相应 的 键 值 ， 一切 就 完工 了 。 这 样 直接 查看 build.gradle 文 
件 是 无 法 看 到 keystore 文 件 的 各 种 信息 的 ,只 有 查看 gradle.properties 文 件 才能 看 得 到。 然后 
我 们 只 需要 将 gradle.properties 文 件 保护 好 就 行 了 ,比如 说 将 它 从 Git 版 本 控制 中 排除 。 这 样 
gradle.properties 文 件 就 只 会 保留 在 本 地 ， 从 而 也 就 不 用 担心 Keystore 文 件 的 信息 会 泄漏 了 。 
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15.9 ”你 还 可 以 做 的 事情 


整 章 内 容 已 经 全 部 学 完了 ， 现 在 回想 一 下 ， 我们 的 代码 是 不 是 使 用 MVVM 架 构 的 模式 来 实现 的 
呢 ? 这 里 我 根据 前 面 编写 的 代码 画 出 了 一 张 SunnyWeather 项 目的 架构 示意 图 , 如 图 15.48 所 
示 。 相 信 对 于 现在 的 你 来 说 ， 理 解 起 来 应 该 是 非常 轻松 的 。 


MainActivity 和 
WeatherActivity 
PlaceFragment 
PlaceViewModel WeatherViewModel 


SharedPreferences 


SunnyWeatherNetwork 
Retrofit 


图 15.48 SunnyWeather 项 目的 架构 示意 图 


可 以 看 出 ， 我 们 编写 的 代码 是 严格 按照 MVVM 架 构 来 实现 的 ， 且 拥有 合理 的 架构 分 层 。 记 住 ， 
一 个 拥有 良好 积 构 设 计 的 项 目 是 可 以 用 简洁 清晰 的 架构 图 表示 出 来 的 ， 而 一 个 杂乱 无 章 没有 染 
构 设 计 的 项 目 则 很 难 用 架构 图 表示 出 来 。 所 以 希望 你 在 未 来 编写 代码 的 时 候 ， 可 以 写 出 高 质量 
且 拥 有 染 构 设计 的 代码 。 


那么 经 过 整 章 的 开发 之 后 ，SunnyWeather 已 经 是 一 个 完善 、 成 熟 的 App 了 吗 ? 嘿嘿 ， 还 差 得 
远 呢 ! 现在 的 SunnyWeather 只 能 说 是 具备 了 一 些 最 基本 的 功能 ， 和 那些 商用 的 天 气 软件 比 起 
来 还 有 很 大 的 差距 ， 因 此 你 仍然 还 有 非常 巨大 的 发 挥 空间 来 对 它 进行 完善 。 


比如 说 ， 以 下 功能 是 你 可 以 考虑 加 入 SunnyWeather 中 的 : 
。 提供 更 加 完整 的 天 气 信息 ， 目 前 我 们 只 使 用 了 彩云 天 气 返 回 的 一 小 部 分 数据 而 已 ; 
。 人 允许 选择 多 个 城市 ， 可 以 同时 观察 多 个 城市 的 天 气 信息 ， 不 用 来 回 切换 ; 


。 增 加 后 台 更 新 天 气功 能 ， 并 允许 用 户 手动 设 定 后 台 的 更 新 频率 ; 
。 对 深 色 主题 进行 适 配 。 
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另外 , 由 于 SunnyWeather 的 源码 已 经 托管 在 了 GitHub 上 面 , 如 果 你 想 在 现 有 代码 的 基础 上 继 
续 对 这 个 项 目 进行 完善 ， 可 以 使 用 GitHub 的 Fork 功 能 。 


首先 登录 你 自己 的 GitHub 账 号 ， 然 后 打开 SunnyWeather 版 本 库 的 主页 : 
https://github.com/guolindev/SunnyWeather , 这 时 在 页 面 头 部 的 最 右 侧 会 有 一 
个 “Fork" 按 钮 ， 如 图 15.49 所 示 。 


@Unwatchv 0 食 Star 0 WFork 0 


图 15.49 ” GitHub 的 “Fork” 按 钮 


点 击 一 下 “Fork” 按 钮 , 就 可 以 将 SunnyWeather 这 个 项 目 复制 一 份 到 你 的 账号 下 ， 再 使 用 git 
clone 命 令 将 它 克隆 到 本 地 ,然后 你 就 可 以 在 现 有 代码 的 基础 上 随心 所 谷地 添加 任何 功能 并 提 
交 了 。 
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第 16 章 ”编写 并 发 布 一 个 开源 库 ， 


PermissionX 


进入 了 本 书 的 最 后 一 章 ， 我 们 的 Android 学 习 之 旅 也 接近 尾声 了 。 学 完整 本 书 ， 你 应 该 能 够 发 
现 ， 我 个 人 是 不 太 喜 欢 使 用 纯 理论 知识 的 讲解 形式 的 ， 而 是 更 加 偏向 于 边 实战 边 讲解 ， 在 实战 
中 学 习 的 这 种 形式 。 因 此 ,学 到 这 里 ， 你 其 实 已 经 编写 过 数 不 清 的 小 项 目 了 ， 并 且 还 在 上 一 章 
中 开发 了 一 个 完整 的 App。 


在 编写 项 目的 时 候 ， 我 们 可 能 经 常会 使 用 一 些 好 用 的 第 三 方 开源 库 ， 比 如 Retrofit、Glide 等 。 
将 这 些 开 源 库 引 入 项 目 中 非常 简单 ， 只 需要 在 build.gradle 的 dependencies 中 添加 一 行 库 的 
引用 地 址 就 可 以 了 。 那 么 你 有 没有 想 过 ， 我 们 可 不 可 以 自己 也 开发 一 个 开源 库 ， 然 后 提供 给 其 
他 的 开发 者 去 使 用 呢 ? 答案 当然 是 肯定 的 ， 本 章 我 们 就 来 学 习 一 下 这 方面 的 技术 。 
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16.1 开发 前 的 准备 工作 


先 解释 一 下 ， 无 论 是 否 开源 ， 只 要 是 编写 一 个 库 提 供给 其 他 的 项 目 去 使 用 ， 就 可 以 统称 为 SDK 
开发 。 


SDK 开 发 和 传统 的 应 用 程序 开发 会 有 一 些 不 同 之 处 。 首 先 ，SDK 开 发 界面 相关 的 工作 会 相对 比 
较 少 , 许多 库 甚 至 是 完全 没有 界面 的 ， 因 此 SDK 开 发 多 数 情况 下 是 以 实现 功能 逻辑 为 主 的 。 


其 次 ， 产 品 的 形式 不 同 。 应 用 程序 开发 的 最 终 产 品 可 能 是 一 个 可 安装 的 APK 文 件 ， 而 SDK 开发 
的 最 终 产品 通常 是 一 些 库 文件 ,甚至 只 有 一 个 库 的 引用 地 址 。 


最 后 ,面向 的 用 户 群体 不 同 。SDK 开 发 面向 的 用 户 群 体 从 来 都 不 是 普通 用 户 ,而 是 其 他 开发 
者 。 因 此 如 何 让 我 们 编写 的 库 可 以 保持 稳定 的 工作 ， 同 时 还 能 提供 简单 方便 的 接口 给 其 他 开发 
者 去 调用 ， 这 是 我 们 应 该 优先 考虑 的 事情 。 


需要 注意 的 大 概 就 是 以 上 几 点 了 “， 其 实 大 部 分 的 编程 思维 和 之 前 是 差不多 的 ， 因 此 你 一 定 能 非 
常 快速 地 掌握 这 项 技能 。 


接 下 来 要 考虑 的 问题 就 是 ， 我 们 应 该 编写 一 个 什么 样 的 开源 库 呢 ? 其 实在 之 前 的 Kotlin 课 堂 中 我 
们 已 经 编写 过 许多 好 用 的 工具 方法 了 ， 这些 工具 方法 都 可 以 被 封装 成 一 个 开源 库 ， 提 供给 其 他 
项 目 去 使 用 。 不 过 为 了 能 够 更 加 丰富 地 讲解 本 章 内 容 ， 我 还 是 重新 思考 了 一 个 全 新 的 开源 库 项 
目 来 进行 实现 。 


回顾 一 下 ， 在 第 8 章 中 我 们 曾经 学 习 过 Android 运 行 时 权限 API 的 用 法 ， 比 如 要 实现 拨打 电话 的 
功能 ,示例 写法 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 
override fun onCreate(savedInstanceState: Bundle?) { 


if (ContextCompat.checkSelfPermission(this, Manifest.permission.CALL PHONE) != 
PackageManager .PERMISSION GRANTED) { 
ActivityCompat.requestPermissions(this, array0f (Manifest.permission. 
CALL PHONE), 1) 
} else { 
call() 


} 


override fun onRequestPermissionsResult(requestCode: Int, permissions: 
Array<String>, grantResults: IntArray) { 
super.onRequestPermissionsResult(requestCode, permissions, grantResults) 
when (requestCode) { 
1 -> { 


if (grantResults.isNotEmpty() && 
grantResults[0] == PackageManager.PERMISSION GRANTED) { 
call() 
} else { 
Toast.makeText(this, "You denied the permission", 
Toast.LENGTH SHORT).show() 
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} 


private fun call() { 


} 


} 


可 以 看 到 ， 这 种 系统 内 置 的 运行 时 权限 API 的 用 法 还 是 非常 烦琐 的 ， 需 要 先 判断 用 户 是 人 否 已 授权 
我 们 拨打 电话 的 权限 ， 如 果 没 有 的 话 则 要 进行 权限 申请 ， 然 后 还 要 在 
onRequestPermissionsResulLt () 回 调 中 处 理 权 限 申 请 的 结果 ， 最 后 才能 去 执行 拨打 电话 的 
操作 。 


为 此 ， 每 次 需要 编写 运行 时 权限 相关 代码 的 时 候 ， 我 都 会 特别 头疼 。 那 么 我 们 可 不 可 以 编写 一 
个 开源 库 来 简化 运行 时 权限 API 的 用 法 呢 ? 没 错 ， 这 就 是 本 章 中 所 要 实现 的 功能 了 。 


不 过 ， 在 开始 实现 之 前 ， 我 们 还 得 给 这 个 开源 库 起 一 个 好 听 的 名 字 才 行 。Android 官 方 的 许多 功 
能 扩展 库 是 以 AndroidX 的 形式 发 布 的 ， 那 么 这 里 我 们 就 给 它 起 名 叫 PermissionX 吧 ， 这 听 上 去 
像 是 一 个 不 错 的 名 字 。 


起 好 了 名 字 之 后 ， 接 下 来 需要 在 GitHub 上 创建 一 个 相应 的 版 本 库 。 创 建 的 方式 我 们 在 上 一 章 的 
Git 时 间 环 节 已 经 学 过 了 ， 因 此 这 里 我 就 用 尽量 简短 的 篇 幅 来 描述 这 个 过 程 ， 如 图 16.1 所 示 。 


Owner Repository name * 
站 guolindev ~ / PermissionX Vv 


Great repository names are short and memorable. Need inspiration? How about refactored-octo-invention? 


Description (optional) 


© Public 


J Anyone can see this repository. You choose who can commit 
MM Private 
| You choose who can see and commit to this repository. 
Skip this step if you're importing an existing repository. 


@ Initialize this repository with a README 


This will let you immediately clone the repository to your computer 


Add .gitignore: Android ~ Add a license: Apache License 2.0 ~ © 


图 16.1 创建 PermissionX 版 本 库 
点 击 “Create repository” 按 钮 即 可 完成 版 本 库 的 创建 。 


接着 在 Android Studio 中 新 建 一 个 Android 项 目 ,项 目 名 也 叫 作 PermissionX , 包 名 叫 作 
com.permissionx.app， 如 图 16.2 所 示 。 
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'® 入 Create New Project 
Configure your project 
Name 
PermissionX 


Package name 


ald chlo smd 


Save location 


Users/guolin/AndroidStudioProjects/AndroidFirstLine/PermissionX 
Language 


Kotlin 


Minimum APllevel API21: Android 5.0 (Lollipop) 


Empty Activity ©@ Your app will run on approximately 85.0% of devices. 
T O00SE 


1elp me 


This project will support instant apps 


Creates a new empty activity 


Cancel Previous | Fnish | 
图 16.2 创建 PermissionX 项 目 
点 击 “Finish” 按 钮 完成 项 目的 创建 。 


接 下 来 我 们 需要 将 PermissionX 的 远程 版 本 库 克 隆 到 本 地 ， 点击 版 本 库 主页 中 的 “Clone or 
download" 按 钮 ， 能 够 查看 到 PermissionX 版 本 库 的 Git 地 址 ， 如 下 所 示 : 


https://github.com/guolindev/PermissionX.git 


然后 打开 终端 界面 并 切换 到 PermissionX 的 工程 目录 下 ， 执行 以 下 命令 把 远程 版 本 库 克 降 到 本 
地 ,如 图 16.3 所 示 。 


git clone https://github.com/guolindev/PermissionX.git 


guolindeMacBook-Pro:~ guolin$ cd AndroidStudioProjects/AndroidFirstLine/PermissionX/ 
guolindeMacBook-Pro:PermissionX guolin$ git clone https://github.com/guolindev/PermissionX.git 
Cloning into 'PermissionX'... 

remote: Enumerating objects: 5，done. 


remote: Counting objects: 100% (5/5), done. 

remote: Compressing objects: 100% (4/4), done. 

remote: Total 5 (delta 0), reused 0 (delta 0), pack-reused 0 
Unpacking objects: 100% (5/5), done. 
guolindeMacBook-Pro:PermissionX guolin$ 


16.3 ”将 远程 版 本 库 克 隆 到 本 地 


接 下 来 将 克隆 的 所 有 文件 全 部 复制 到 上 一 层 目录 中 ， 操 作 方法 和 上 一 章 是 完全 相同 的 。 然 后 将 
克隆 的 PermissionX 目 录 删 除 , 现在 PermissionX 工 程 的 目录 结构 应 该 如 图 16.4 所 示 。 


www.blogss.cn 


guolindeMacBook-Pro:PermissionX guolin$ ls -al 

total 104 

drwxr-xr-x 17 guolin staff 544 10 

drwxr-xr-x 35 guolin staff 1120 10 A 

drwxr-xr-x 12 guolin staff 384 10 EF .git 

-rwW-r--r-- guolin staff 1002 10 - .gitignore 
drwxr-xr-x guolin staff 160 10 F- .gradle 
drwxr-xr-x guolin staff 352 10 : .idea 

-rwW-r--r-- guolin staff 10 :49 LICENSE 
-rw-r--r-- guolin staff 10 :41 PermissionX.iml 
-FW-r--r-- guolin staff 10 :49 README .md 
drwxr-xr-x guolin staff 10 :41 app 

-PW-P--P-- guolin staff :40 build.gradle 
drwxr-xr-x guolin staff :40 gradle 
-rwW-r--r-- guolin staff :41 gradle.properties 
-FWXr--r-- guolin staff :40 gradlew 
-PrW-r--r-- guolin staff :40 gradlew.bat 
-rwW-r--r-- guolin staff 2 local .properties 
-rwW-r--r-- 1 guolin staff :40 settings.gradle 
guolindeMacBook-Pro:PermissionX guolin$ 


un 


1 
1 
aL 
1 
9 
1 
3 
和 
1 
1 


图 16.4 PermissionX 工 程 的 目录 结构 
最 后 ， 我 们 需要 把 PermissionX 项 目 中 现 有 的 文件 提交 到 GitHub 上 面 ， 执 行 以 下 命令 即 可 : 


git add . 
git commit -m "First commit." 
git push origin master 


到 这 里 ， 开 发 前 的 所 有 准备 工作 都 已 经 完成 了 ， 那么 接 下 来 就 让 我 们 正式 进入 PermissionX 开 
源 库 的 开发 当中 吧 。 
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16.2 实现 PermissionX 开 源 库 


不 知 你 是 否 留意 过 ， 之 前 我 们 编写 的 所 有 代码 都 是 在 app 目 录 下 进行 的 。 这 其 实 是 一 个 专门 用 于 
开发 应 用 程序 的 模块 。 而 现在 我 们 要 开发 的 是 一 个 库 ， 因 此 就 不 适合 将 代码 继续 写 在 app 模 块 中 
了 。 


实际 上 , 一 个 Android 项 目 中 可 以 包含 任意 多 个 模块 ， 并 且 模 块 与 模块 之 间 可 以 相互 引用 。 比 方 
说 ， 我 们 在 模块 A 中 编写 了 一 个 功能 ， 那 么 只 需要 在 模块 B 中 引入 模块 A， 模 块 B 就 可 以 无 缝 地 使 
用 模块 A 中 提供 的 所 有 功能 。 


接 下 来 我 们 就 在 PermissionX 项 目 中 新 建 一 个 模块 ， 并 在 这 个 模块 中 实现 具体 的 功能 。 对 着 最 
顶层 的 PermissionX 目 录 右 击 ”New 一 Module , 会 弹出 一 个 创建 模块 的 对 话 框 ， 如 图 16.5 所 
示 。 


®@ @ Create New Module 


人 New Module 


Phone & Tablet Module Dynamic Feature Module Instant Dynamic Feature Module 


可 
可 


Wear OS Module Android TV Module Android Things Module Import Gradle Project 


图 16.5 “创建 模块 对 话 框 


选中 “Android Library”, 表示 我 们 要 创建 一 个 Android 库 ， 然 后 点 击 ^Next”, 界面 如 图 16.6 
所 示 。 
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© @ Create New Module 


人 Android Library 


Configure the new module 


Application/Library name 
Library 


Module name 
library 


Package name 
com.permissionx.guolindev Edit 


Language 
Kotlin 
Minimum SDK 
API 21: Android 5.0 (Lollipop) 


图 16.6 配置 库 的 名 称 与 包 名 


这 里 要 配置 库 的 名 称 ， 我们 直接 起 名 叫 Library 就 好 了 。 人 至 于 包 名 的 话 ， 由 于 要 尽量 避免 和 别人 
的 代码 产生 冲突 ， 因 此 最 好 起 一 些 具有 唯一 性 的 名 字 ， 比 如 这 里 我 将 包 名 命名 成 了 
com.permissionx.guolindev， 你 在 实现 的 时 候 应 该 将 最 后 的 部 分 蔡 换 成 你 自己 的 名 字 。 


点 击 “Finish” 按 钮 完成 创建 ， 现 在 PermissionX 工 程 目录 下 应 该 就 有 app 和 library 两 个 模块 
了 , 如 图 16.7 所 示 。 
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时 PermissionX 
Ml .gradle 
.jdea 
5 app 
gradle 
i library 
.gitignore 
build.gradle 
Wl gradle.properties 
= gradlew 
=s gradlew.bat 
国 LICENSE 
引 local.properties 
总 PermissionX.iml 
ss README.md 
settings.gradle 


图 16.7 PermissionX 工 程 目录 结构 


可 以 看 到 ,app 和 library 这 两 个 模块 的 目录 图 标 也 是 不 同 的 ， 这 是 为 了 让 我 们 能 够 更 好 地 区 分 
应 用 程序 模块 和 库 模 块 。 


另外 ， 观 察 一 下 library 模 块 中 的 build.gradle 文 件 ， 其 简化 后 的 代码 如 下 所 示 : 


apply plugin: "com.android.Library' 
apply plugin: 'kotlin-android' 
apply plugin: 'kotlin-android-extensions' 


android { 

compileSdkVersion 29 

defaultConfig { 
minSdkVersion 21 
targetSdkVersion 29 
versionCode 1 
versionName "1.0" 
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" 
consumerProguardFiles 'consumer-rules.pro' 


你 会 发 现 尼 和 app 模 块 中 的 build.gradle 文 件 有 两 个 重要 的 区 别 : 第 一 ， 这 里 头 部 引入 的 插件 是 
com.android.library , 表示 这 是 一 个 库 模 块 , 而 app/build.gradle 文 件 头 部 引入 的 插件 是 
com.android.application ,表示 这 是 一 个 应 用 程序 模块 ; 第 二 ,这 里 的 defauLtConfig 闭 包 
中 是 不 可 以 配置 appLicationId 属 性 的 ,而 app/build.gradle 中 则 必须 配置 这 个 属性 ， 用 于 
作为 应 用 程序 的 唯一 标识 。 
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了 解 了 应 用 程序 模块 和 库 模块 的 主要 区 别 之 后 ， 接 下 来 我 们 就 开始 在 library 模 块 中 实现 
PermissionX 的 具体 功能 吧 。 


其 实 ， 想 要 对 运行 时 权限 的 API 进 行 封装 并 不 是 一 件 容 易 的 事 ， 因 为 这 个 操作 是 有 特定 的 上 下 文 
依赖 的 ， 一 般 需 要 在 Activity 中 接收 onRequestPermissionsResutLt () 方 法 的 回调 才 行 ， 所 
以 不 能 简单 地 将 整个 操作 封装 到 一 个 独立 的 类 中 。 当 然 ， 受 此 限制 ， 也 衍生 出 了 一 些 特别 的 解 
决 方案 ， 比 如 将 运行 时 权限 的 操作 封装 到 BaseActivity 中 ， 或 者 提供 一 个 透明 的 Activity 来 
处 理 运行 时 权限 等 。 


这 里 我 并 不 准备 使 用 以 上 几 种 方案 ， 而 是 准备 使 用 另外 一 种 业内 普遍 比较 认可 的 小 技巧 来 进行 
实现 。 是 什么 小 技巧 呢 ? 回想 一 下 , 之 前 所 有 申请 运行 时 权限 的 操作 都 是 在 Activity 中 进行 的 ， 
事实 上 ,， Google 在 Fragment 中 也 提供 了 一 份 相同 的 API ,使 得 我 们 在 Fragment 中 也 能 申请 运 
行 时 权限 。 


但 不 同 的 是 ，Fragment 并 不 像 Activity 那 样 必须 有 界面 ， 我 们 完全 可 以 向 Activity 中 添加 一 个 
隐藏 的 Fragment ,然后 在 这 个 隐藏 的 Fragment 中 对 运行 时 权限 的 API 进 行 封装 。 这 是 一 种 非 
常 轻 量 级 的 做 法 ， 不 用 担心 隐藏 Fagment 会 对 Activity 的 性 能 造成 什么 影响 。 


确定 好 了 实现 方案 之 后 ， 那 么 就 开始 动手 吧 。 右 击 com.permissionx.guolindev 包 
一 New 一 Kotlin File/Class，, 新建 一 个 InvisibLeFragment 类 ， 并 让 它 继承 自 
androidx.fragment.app.Fragment。 


然后 在 InvisibLeFragment 中 对 运行 时 权限 的 API 进 行 封装 ， 代 码 如 下 所 示 : 


class InvisibleFragment : Fragment() { 
private var callback: ((Boolean, List<String>) -> Unit)? = null 


fun requestNow(cb: (Boolean, List<String>) -> Unit, vararg permissions: String) { 
callback = cb 
requestPermissions(permissions, 1) 


override fun onRequestPermissionsResult(requestCode: Int, 
permissions: Array<String>, grantResults: IntArray) { 
if (requestCode == { 
val deniedList = ArrayList<String>() 
for ((index, result) in grantResults.withIndex()) { 
if (result != PackageManager.PERMISSION GRANTED) { 
deniedList.add(permissions[index]) 
} 


} 

val allGranted = deniedList.isEmpty() 

callback?.let { it(allGranted, deniedList) } 
= 


} 


} 
这 段 代码 虽然 不 长 ， 但 是 所 包含 的 内 容 却 极其 关键 。 首 先 我 们 定义 了 一 个 caLLback 变 量 作为 运 


行 时 权限 申请 结果 的 回调 通知 方式 ， 并 将 它 声 明成 了 一 种 函数 类 型 变量 ， 该 水 数 类 型 接收 
Boolean 和 List<String> 这 两 种 类 型 的 参数 ， 并 且 没 有 返回 值 。 
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然后 定义 了 一 个 requestNow() 方 法 ,该 方法 接收 一 个 与 cal lback 变 量 类 型 相同 的 少数 类 型 
参数 ， 同 时 还 使 用 vararg 关 键 字 接收 了 一 个 可 变 长 度 的 permissions 参 数列 表 。 在 
requestNow( ) 方 法 中 ， 我们 将 传递 进来 的 函数 类 型 参数 赋值 给 caLLback 变 量 ， 然 后 调用 
Fragment 中 提供 的 requestPermissions () 方 法 去 立即 申请 运行 时 权限 ， 并 将 
permissions 参 数列 表 传 递 进去 ， 这 样 就 可 以 实现 由 外 部 调用 方 自主 指定 要 申请 哪些 权限 的 功 


能 了 。 


接 下 来 还 需要 重 写 onRequestPermissionsResult() 方 法 ,并 在 这 里 处 理 运行 时 权限 的 申请 
结果 。 可 以 看 到 ， 我们 使 用 了 一 个 deniedList 列 表 来 记录 所 有 被 用 户 拒绝 的 权限 ， 然 后 遍历 
grantResults 数 组 ， 如果 发 现 某 个 权限 未 被 用 户 授权 ， 就 将 它 添加 至 JdeniedList 中 。 遍 历 
结束 后 使 用 一 个 aLLGranted 变 量 来 标识 是 否 所 有 申请 的 权限 均 已 被 授权 ， 判 断 的 依据 就 是 
deniedList 列 表 是 否 为 空 。 最 后 使 用 caLLback 变 量 对 运行 时 权限 的 申请 结果 进行 回调 。 


另外 注意 ， 在 InvisibleFragment 中 ， 我 们 并 没有 重 写 onCreateView( ) 方 法 来 加 载 某 个 布 
局 ， 因 此 它 自然 就 是 一 个 不 可 见 的 Fragment， 待 会 只 需要 将 它 添加 到 Activity 中 即 可 。 


不 过 ,上述 代码 其 实 还 有 进一步 优化 的 空间 。 你 应 该 也 能 感觉 到 ，(Bootean， 
List<String>) -> Unit 这 种 函数 类 型 的 写法 是 比较 复杂 的 ， 而 且 我 们 还 不 只 编写 了 一 次 ， 
编写 的 次 数 越 多 ， 你 就 会 觉得 越 抹 烦 。 对 于 这 种 情况 ， 其 实 是 可 以 使 用 如 下 写法 来 进行 优化 
的 : 


typealias PermissionCallback = (Boolean, List<String>) -> Unit 
class InvisibleFragment : Fragment() { 
private var callback: PermissionCallback? = null 
fun requestNow(cb: PermissionCallback, vararg permissions: String) { 


callback = cb 
requestPermissions(permissions, 1) 


} 


这 里 用 到 了 Kotlin 中 的 一 个 小 技巧 , typeaLias 关 键 字 可 以 用 于 给 任意 类 型 指定 一 个 别名 ， 比 
如 我 们 将 (BooLean，List<String>) -> Unit 的 别名 指定 成 了 PermissionCaLLback ， 
这 样 就 可 以 使 用 PermissionCallback 来 替代 之 前 所 有 使 用 (Boolean，List<String>) - 
> Unit 的 地 方 ， 从 而 让 代码 变 得 更 加 简洁 易 懂 。 


完成 了 InvisibLeFragment 的 编写 ， 接 下 来 我 们 需要 开始 编写 对 外 接口 部 分 的 代码 了 。 新 建 
一 个 PermissionX 单 例 类 ,代码 如 下 所 示 : 


object PermissionX { 
private const val TAG = "InvisibleFragment" 


fun request(activity: FragmentActivity, vararg permissions: String, callback: 
PermissionCallback) { 
val fragmentManager = activity.supportFragmentManager 
val existedFragment = fragmentManager.findFragmentByTag (TAG) 
val fragment = if (existedFragment != null) { 
existedFragment as InvisibleFragment 
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} else { 
val invisibleFragment = InvisibleFragment() 
fragmentManager.beginTransaction().add(invisibleFragment, TAG).commitNow() 
invisibleFragment 


fragment.requestNow(callback, *permissions) 


} 


这 里 之 所 以 要 将 PermissionX 指 定 成 单 例 类 ， 是 为 了 让 PermissionX 中 的 接口 能 够 更 加 方便 地 
被 调用 。 我 们 在 PermissionX 中 定义 了 一 个 request ( ) 方 法 ， 这 个 方法 接收 一 个 
FragmentActivity 参 数 、 一 个 可 变 长 度 的 permissions 参 数列 表 ， 以 及 一 个 caLLback 回 
调 。 其 中 , FragmentActivity 是 AppCompatActivity 的 父 类 。 


在 request ( ) 方 法 中 ,首先 获取 FragmentManager 的 实例 ， 然 后 调用 
findFragmentByTag () 方 法 来 判断 传 入 的 Activity 参 数 中 是 否 已 经 包含 了 指定 TAG 的 
Fragment , 也 就 是 我 们 刚才 编写 的 LnvisibleFragment。 如 果 已 经 包含 则 直接 使 用 该 
Fragment , 否则 就 创建 一 个 新 的 InvisibLeFragment 实 例 ,并 将 它 添加 到 Activity 中 ， 同 时 
指定 一 个 TAG。 注 意 ， 在 添加 结束 后 一 定 要 调用 CommitNow ( ) 方 法 ， 而 不 能 调用 Commit ( ) 方 
法 ， 因 为 commit ( ) 方 法 并 不 会 立即 执行 添加 操作 ， 因 而 无 法 保证 下 一 行 代 码 执行 时 
InvisibleFragment 已 经 被 添加 到 Activity 中 了 。 


有 了 InvisibleFragment 的 实例 之 后 ， 接 下 来 我 们 只 需要 调用 它 的 requestNow( ) 方 法 就 能 
申请 运行 时 权限 了 ， 申 请 结果 会 自动 回调 到 callback 参 数 中 。 需 要 注意 的 是 ， permissions 
参数 在 这 里 实际 上 是 一 个 数组 。 对 于 数组 ， 我 们 可 以 遍历 它 ， 可 以 通过 下 标 访问 ， 但 是 不 可 以 
直接 将 它 传递 给 另外 一 个 接收 可 变 长 度 参 数 的 方法 。 因 此 ， 这 里 在 调用 requestNow( ) 方 法 
时 ，, 在 permissions 参 数 的 前 面 加 上 了 一 个 *， 这 个 符号 并 不 是 指针 的 意思 ，, 而 是 表示 将 一 个 
数组 转换 成 可 变 长 度 参数 传递 过 去 。 


代码 写 到 这 里 ,我 们 就 已 经 按照 之 前 所 设计 的 实现 方案 将 运行 时 权限 的 API 封 装 完成 了 。 现 在 如 
果 想 要 申请 运行 时 权限 ， 只 需要 调用 PermissionX 中 的 request () 方 法 即 可 。 


那么 接 下 来 我 们 要 做 的 ， 就 是 对 刚刚 开发 完成 的 PermissionX 库 进行 测试 。 
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16.3 ”对 开源 库 进 行 测试 
虽然 PermissionX 库 的 开发 工作 已 经 完成 了 ， 但 是 我 们 目前 还 无 法 验证 它 是 否 可 以 正常 地 使 
用 。 因 此 ， 在 将 一 个 开源 库 对 外 发 布 之 前 ， 一 定 要 先 对 其 进行 测试 才 行 。 


具体 要 怎样 进行 测试 呢 ? 我 们 可 以 在 app 模 块 中 引入 library 模 块 ， 然 后 在 app 模 块 中 使 用 
PermissionX 提 供 的 接口 编写 一 些 申请 运行 时 权限 的 代码 ， 看 看 能 否 正常 地 工作 ， 以 此 来 验证 
PermissionX 库 的 正确 性 。 


想 要 在 app 模 块 中 引入 library 模 块 很 简单 ， 只 需要 编辑 app/build.gradle 文 件 ， 并 在 
dependencies 中 添加 如 下 代码 即 可 : 


dependencies { 


implementation project(':library') 


现在 就 可 以 在 app 模 块 中 无 缝 地 使 用 library 模 块 提供 的 所 有 功能 了 。 


接 下 来 我 们 开始 编写 测试 代码 ， 首先 编辑 activity_main.xml 文 件 ， 在 里 面 加 入 一 个 用 于 拨打 电 
话 的 按钮 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent"> 


<Button 
android:id="@+id/makeCallBtn" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:text="Make Call" /> 


</LinearLayout> 


然后 在 MainActivity 中 申请 拨打 电话 的 运行 时 权限 ， 并 实现 拨打 电话 的 功能 ， 代 码 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
makeCallBtn.setOnClickListener { 
PermissionX.request(this, 
Manifest.permission.CALL PHONE) { allGranted, deniedList -> 
if (allGranted) { 
call() 
} else { 
Toast.makeText (this, "You denied $deniedList", 
Toast.LENGTH SHORT) .show() 


} 


private fun call() { 
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try { 
val intent = Intent(Intent.ACTION _ CALL) 
intent .data = Uri.parse("tel:10086") 
startActivity(intent) 

} catch (e: SecurityException) { 
e.printStackTrace() 

} 


} 


可 以 看 到 ， 现在 MainActivity 中 的 逻辑 是 非常 简洁 清晰 的 。 我 们 完全 不 用 再 去 编写 那些 复杂 的 
运行 时 权限 相关 的 代码 ， 只 需要 调用 PermissionX 的 request ( ) 方 法 ， 传 入 当前 的 Activity 和 
要 申请 的 权限 名 ， 然 后 在 Lambda 表 达 式 中 处 理 权 限 的 申请 结果 就 可 以 了 。 如 果 aLLGranted 
等 于 t rue， 就 说 明 所 有 申请 的 权限 都 被 用 户 授权 了 ,那么 就 执行 拨打 电话 操作 ， 否 则 使 用 
Toast 弹 出 一 条 失败 提示 。 


另外 ，PermissionX 也 支持 一 次 性 申请 多 个 权限 ， 只 需要 将 所 有 要 申请 的 权限 名 都 传 入 
request() 方 法 中 就 可 以 了 ， 示例 写法 如 下 : 


PermissionX.request(this, 
Manifest.permission.CALL PHONE, 
Manifest.permission.WRITE EXTERNAL STORAGE, 
Manifest.permission.READ CONTACTS) { allGranted, deniedList -> 
if (allGranted) { 
Toast.makeText(this, "All permissions are granted", Toast.LENGTH SHORT).show() 
} else { 


Toast.makeText(this, "You denied $deniedList", Toast.LENGTH SHORT) .show() 
} 


} 


最 后 , 仍然 不 要 忘记 在 AndroidManifest.xm | 文件 中 添加 拨打 电话 的 权限 声明 ， 代码 如 下 所 
人 小 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.permissionx.app"> 


<uses-permission android:name="android.permission.CALL PHONE" /> 


</manifest> 


这 样 我 们 就 将 拨打 电话 的 功能 成 功 实现 了 ， 现 在 可 以 运行 一 下 app 模 块 ， 并 点 击 ^Make Call” 按 
钮 ， 结 果 如 图 16.8 所 示 。 
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\ 


Allow PermissionX to make and 
manage phone calls? 


图 16.8 申请 拨打 电话 权限 


可 以 看 到 ,界面 上 成 功 弹 出 了 权限 申请 的 对 话 框 ， 说明 PermissionX 库 确实 已 经 在 正常 工作 
了 。 当 然 这 里 我 们 可 以 选择 同意 或 者 拒绝 ， 比 如 说 点 击 “Deny" 按 钮 ,结果 如 图 16.9 所 示 。 
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9:29 


PermissionX 


MAKE CALL 


You denied 
[android.permission.CALL_PHONE] 


图 16.9 拒绝 了 拨打 电话 权限 申请 


然后 再 次 点 击 ^“Make Call” 按 钮 ,仍然 会 弹出 权限 申请 的 对 话 框 ,这 次 点 击 “Allow ”按钮 , 结 
如 图 16.10 所 示 。 
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Calling.. 


10086 


图 16.10 ”拨打 电话 界面 


一 切 都 和 我 们 所 预期 的 结果 一 致 ， 这 样 对 PermissionX 库 的 测试 工作 就 算是 全 部 完成 了 ， 现 在 
可 以 将 测试 后 的 代码 提交 到 GitHub 上面。 


git add . 
git commit -m“" 完 成 PermissionX 库 的 开发 与 测试 工作 。" 


git push origin master 


开发 和 测试 工作 完成 之 后 ， 接 下 来 我 们 要 做 的 事情 就 是 将 PermissionX 库 发 布 出 去 ， 赶 快 进入 
下 一 节 的 学 习 当中 吧 。 
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16.4 将 开源 库 发 布 到 jcenter 仓 库 


相信 你 已 经 体验 过 很 多 次 了 ， 我们 平时 在 开发 过 程 中 如 果 用 到 了 一 些 第 三 方 开源 库 ， 只 需要 在 
build.gradle 的 dependencies 中 添加 一 行 库 的 引用 地 址 就 可 以 了 ,Android Studio 会 自动 帮 
我 们 下 载 该 库 , 并 引入 当前 项 目的 开发 环境 中 。 


那么 ,这么 好 用 的 功能 是 如 何 实现 的 呢 ? 关于 这 一 点 ， 其 实 我 在 第 1 章 就 介绍 过 了 ， 每 一 个 
Android 项 目 工程 最 外 层 目 录 下 的 build.gradle 文 件 中 都 会 默认 配 有 一 个 jcenter 仓 库 , 如 下 所 
示 : 


buildscript { 
repositories { 
google() 
jcenter() 


} 


allprojects { 
repositories { 
google() 
jcenter() 


} 


可 以 看 到 ， 这 里 配置 了 google 和 jcenter 两 个 仓库 。 其 中 google 仓 库 中 包含 的 主要 是 Google 自 
家 的 扩展 依赖 库 ， 而 jcenter 仓 库 中 包含 的 大 多 是 一 些 第 三 方 的 开源 库 ， 比 如 Retrofit、Glide 等 
知名 的 开源 库 都 是 发 布 到 jcenter 仓 库 上 的 。 


也 就 是 说 ， 如 果 我 们 希望 PermissionX 能 够 像 其 他 开源 库 一 样 ， 只 需要 添加 一 行 库 的 引用 地 址 
就 可 以 在 任何 Android 项 目 中 使 用 的 话 ， 就 必须 把 PermissionX 发 布 到 jcenter 仓 库 才 行 ， 下 面 
我 们 就 开始 学 习 如 何 进行 实现 。 

首先 你 需要 注册 一 个 Bintray 账 号 ，Bintray 是 一 个 专门 提供 软件 分 发 服务 的 网 站 ，jcenter 仓 库 


的 发 布 与 下 载 服务 都 是 由 Bintray 提 供 的 ， 它 的 官网 地 址 是 https://bintray.com (部 分 功能 
能 需要 科学 上 网 才能 访问 ) 。 官 网 的 首页 如 图 16.11 所 示 。 
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ray.com 


~ JFrog Bintray search intray 


xn JFrog Bintray 


SS S6ftware Distfibution as a Service 


Universal, Automated, Secure 


For an Open Source Account 
Sign Up Here 


START YOUR FREE TRIAL 


© WhatisJFrog Bintray? 


图 16.11 Bintray 首 页 
点 击 界面 上 的 “Sign Up Here" 即 可 立即 注册 账号 ， 然 后 填 入 一 些 必要 的 信息 ， 如 图 16.12 所 


不 。 


guolindev 


Create My Account 


图 16.12 注册 Bintray 账 号 
点 击 “Create My Account" 按 钮 完成 注册 ,Bintray 会 向 你 填写 的 邮箱 中 发 送 一 封 邮件 ， 到 邮 
箱 中 验证 一 下 即 可 激活 账号 ， 然 后 就 可 以 进入 你 的 Bintray 主 页 了 ， 如 图 16.13 所 示 。 
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0 Lincuo-guolindevisusingB x 十 


和 3 C a bintray.com/guolindey 


~ JFrog Bintray 


guolindev (Lin Guo) 


[7 Edit 


Owned Repositories General 
Search by repository name Emall Sinyu890807@163.com © 
Webslte/Blog 
AIIO) 
Company 
t AddNewRepository 
Location China 


Member Since Nov04,2019 


图 16.13 Bintray 个 人 主页 


接 下 来 ， 我 们 需要 点 击 界面 上 的 "Add New Repository "来 创建 一 个 新 的 仓库 ， 如 图 16.14 所 
不 。 


出 Change Avatar 


® Public - anyone can download your files. 


3 


©@ Upgrade for Private Repositories 


YY 


Request new OSS license type 


Default Licenses (Optional) 


Apache-2.0 @® 


Start typing, 


icense(s) f ew package this rer 


Description (Optional) 


© ee 


图 16.14 ”创建 新 的 仓库 
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其 中 仓库 的 名 字 可 以 随便 填 ， 仓库 的 类 型 要 选择 “Maven”, 开源 许可 我 们 选择 “Apache-2.0”， 
然后 点 击 “Create” 按 钮 完成 创建 。 


创建 成 功 后 会 自动 跳 转 到 新 创建 的 仓库 主页 ， 如 图 16.15 所 示 。 


Repository 'maven' 


图 16.15 仓库 主页 


这 样 在 Bintray 上 的 操作 就 告 一 段落 了 ， 接 下 来 回 到 Android Studio 工 程 中 ， 我 们 需要 在 这 里 
加 入 将 代码 发 布 到 jcenter 仓 库 的 配置 。 


Bintray 官 方 提供 了 一 个 能 够 实现 此 功能 的 插件 ， 但 是 我 个 人 认为 这 个 插件 使 用 起 来 有 点 复杂 ， 
要 编写 很 多 的 Gradle 肢 本 才 行 ， 因 此 这 里 我 们 就 不 使 用 已 了 。 
我 比较 推荐 使 用 的 是 一 个 由 第 三 方 公司 开发 的 插件 : bintray-release。 它 的 用 法 非常 简单 ， 只 


需要 配置 一 些 必要 的 信息 就 可 以 实现 将 代码 发 布 到 jcenter 仓 库 的 功能 。bintray-release 的 
GitHub 主 页 地 址 是 : https://github.com/novoda/bintray-release。 


由 于 我 们 要 发 布 的 是 library 模 块 中 的 代码 ， 因 此 打开 library/build.gradle 文 件 ， 并 在 文件 的 尾 
部 加 入 如 下 配置 : 
appLy plugin: "com.novoda.bintray-reLease' 
buildscript { 
repositories { 


jcenter() 


dependencies { 
classpath 'com.novoda:bintray-release:0.9.1' 


} 


这 上段 配置 就 表示 将 bintray-release 插 件 引 入 library 模 块 中 。 我 在 编写 本 书 时 ， bintray- 
release 的 最 新 版 本 是 0.9.1 ,你 可 以 在 它 的 GitHub 主 页 中 找到 当前 的 最 新 版 本 。 


接 下 来 我 们 还 需要 在 library/build.gradle 文 件 中 加 入 一 段 Publish 闭 包 来 配置 一 些 必 要 的 参 
数 ,如 下 所 示 : 
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publish { 
Userorg = 'guolindev' 
groupId = 'com.permissionx.guolindev' 
artifactId = 'permissionx' 
publishVersion = '1.0.0' 
desc = 'Make Android runtime permission request easy.' 
website = 'https://github.com/guolindev/PermissionX' 


} 


userOrg 部 分 填 入 你 的 Bintray 用 户 名 即 可 。groupld 用 于 作为 组 织 的 唯一 标识 ， 通 常 填 入 公司 
的 倒 排 域名 ,这 里 我 使 用 了 项 目的 包 名 。artifactld 用 于 作为 工程 的 唯一 标识 ， 这 部 分 直接 填 入 
permissionx 就 可 以 了 ， 另 外 你 要 保证 同一 groupld 下 不 会 存在 两 个 相同 的 artifactld。 
publishVersion 表 示 当 前 开源 库 的 版 本 号 ， 我 们 第 一 个 版 本 就 使 用 1.0.0 吧 。desc 用 于 对 你 
开源 库 进行 一 些 简单 的 描述 ，website 中 填 入 PermissionX 的 版 本 库 主 页 地 址 即 可 。 


因此 ， 一 个 依赖 库 的 引用 地 址 的 组 成 结构 应 该 如 下 所 示 : 


'groupId:artifactId:publishVersion' 


那么 根据 我 们 刚才 的 配置 ，PermissionX 库 的 引用 地 址 就 应 该 是 : 


'com.permissionx.guolindev:permissionx:1.0.0' 


注意 , 上 述 配 置 一 定 要 按照 你 的 实际 信息 去 填写 ， 干 万 不 要 完全 照搬 书 上 的 内 容 ， 否 则 可 能 会 
出 现 id 冲 突 从 而 导致 发 布 失败 的 情况 。 


这 样 我 们 就 将 bintray-release 所 要 求 的 所 有 配置 信息 都 填写 完成 了 ， 接 下 来 可 以 点 击 Android 
Studio 底 部 工具 栏 中 的 Terminal 标 签 ， 打开 Terminal 窗 口 ， 如 图 16.16 所 示 。 


Terminal: “ Local + 


guolindeMacBook-Pro:PermissionX guolin$ 


国 Terminal 三 6: Logcat 大 DB Execution Console 江 TODO 片 9: Version Control A Build 


图 16.16 创建 新 的 软件 包 
在 这 里 输入 具体 的 上 传 命令 ， 就 可 以 将 PermissionX 库 上 传 到 我 们 刚刚 创建 的 maven 仓 库 中 。 
如 果 你 使 用 的 是 Windows 系 统 ， 执行 如 下 命令 : 


gradlew clean build bintrayUpload -PbintrayUser=USER -PbintrayKey=KEY -PdryRun=false 


如 果 你 使 用 的 是 Mac 或 Ubuntu 系统 ， 执 行 如 下 命令 : 
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/gradlew clean build bintrayUpload -PbintrayUser=USER -PbintrayKey=KEY -PdryRun=false 
其 中 ，USER 部 分 要 替换 成 你 的 Bintray 用 户 名 ,KEY 部 分 要 替换 成 你 的 Bintray API Key。 那 么 
这 个 API Key 是 什么 呢 ? 我们 可 以 通过 点 击 Bintray 网 站 顶部 的 用 户 名 >Edit Profile 一 API Key 
来 进行 查看 ， 如 图 16.17 所 示 。 


rs JFrogBintray searcn emmy 
Edit Your Profile = 
guolindev (Lin) 
fa M 
1 
API Key 
Y APl key 
a | © revoket | 


图 16.17 查看 API Key 

注意 ， 这 个 API Key 一 定 要 保护 好 , 这 属于 隐私 型 数据 ，, 干 万 不 要 把 它 添加 到 版 本 控制 中 。 

0 述 命令 ， 即 可 完成 PermissionX 库 的 上 传 工 作 。 现 在 刷新 一 下 我 们 刚才 创建 的 仓库 主 
, 结果 如 图 16.18 所 示 。 


Repository 'maven' 
home ~ repositories ~ maven (https://dLbintray.com/guolindev/ma' 


1Package 


Package Name Latest Version Last Update Owner 
1.00 06 Nov 2019 guolindev 


permissionx 


图 16.18 刷新 后 的 仓库 主页 


可 以 看 到 ， 刚刚 上 传 的 PermissionX 库 已 经 显示 在 仓库 主页 中 了 。 现 在 ， 我 们 离 将 它 发 布 到 
jcenter 仓 库 还 差 最 后 一 步 。 点 击 进 入 PermissionX 库 的 详情 界面 ,该 界面 的 右上 角 有 一 个 


Actions 菜 单 ， 展 开 之 后 会 有 一 个 “Add to jcenter "选项 ， 如 图 16.19 所 示 。 
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Package 'permissionx Setmeup Actions 


home ~ rel positories - maven permissionx 名 https 和 
他 Upgradeto Premium 
Make Android runtime permission request easy. Ow AL Edit 
0 downloads 
guolindev 个 Upload Files 
BB watch 
Overvie Ww Read Me Release Notes Communi ty Files Permissions 
Link Packagr 
PD Merge Pack: 
~ About This Package a 
Add to Jcent' 
Website: https://github.com/guolindev/PermissionX 
ep 8 加 TweetVersion 
Issue Tracker: https://github.com/guolindev/PermissionX/issues 
VCS: https://github.com/guolindev/PermissionX.git 
Licenses: Apache-2.0 ] 


图 16.19 PermissionX 库 的 详情 界面 
点 击 “Add to jcenter 选 项 即 可 将 PermissionX 库 发 布 到 jcenter 仓 库 ， 但 是 我 们 最 好 在 弹出 的 
界面 中 再 对 所 提交 的 库 进行 简单 的 描述 ， 如 图 16.20 所 示 。 


Add package to jcenter xX 


Is pom project 
Host my snapshot build artifacts on the OSS Artifactory 


This allows you to have your project's builds snapshots deployed 
to https://oss.jfrog.org and to release and publish them to 
Bintray in one click. 


Please Notice: including this package in JCenter will prevent you 
from making the repository 'maven' private. Also, you will not be 
able to remove this package license and VCS fields. 


Make Android runtime permission request easy. 


图 16.20 ”提交 确认 页 面 


点 击 “Send "按钮 发 送 提交 申请 ， 接 下 来 要 做 的 事情 就 是 等 待 了 。Bintray 的 审核 速度 通常 是 非 
常 快 的 ， 一 般 几 小 时 内 就 会 通过 。 审 核 通过 之 后 你 的 Bintray 账 号 会 收 到 一 封 如 图 16.21 所 示 的 


邮件 。 
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Request to include the package /guolindev/maven/permissionx' in 'jcenter' 


"lz bintray Your request to include your package /guolindev/maven/permissionx in Bintray's JCenter has been approved. 


图 16.21 ” 收 到 审核 通过 的 邮件 
当 收 到 这 封 邮件 时 ， 就 说 明 你 已 经 成 功 将 库 发 布 到 jcenter 仓 库 中 了 。 
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16.5 体验 我 们 的 成 果 


现在 ，PermissionX 已 经 可 以 像 Retrofit、Glide 等 其 他 开源 库 那样 ， 通 过 添加 一 行 库 的 引用 地 
址 就 可 以 引入 到 任何 Android 项 目 工程 中 ， 那 么 我 们 自然 要 来 体验 一 下 了 。 


这 里 我 新 建 了 一 个 PermissionXTest 项 目 ， 使 它 和 原来 的 PermissionX 项 目 保 持 完 全 独立 ， 然 
后 在 app/build.gradle 文 件 中 添加 如 下 依赖 : 


dependencies { 


impLementation "com.permissionx.guoLindev:permissionx:1.0.0' 


点 击 “Sync Now" 完 成 同步 之 后 ,我们 就 可 以 在 代码 中 调用 PermissionX 的 API 了 。 修 改 
MainActivity 中 的 代码 ， 如 下 所 示 : 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super.onCreate(savedInstanceState) 
setContentView(R.layout.activity main) 
PermissionX.request(this, 
Manifest.permission.CALL PHONE, 
Manifest.permission.READ CONTACTS) { allGranted, deniedList -> 
if (allGranted) { 
Toast.makeText(this, "All permissions are granted", 
Toast .LENGTH _ SHORT) .show'() 
} else { 
Toast.makeText (this, "You denied $deniedList", 
Toast .LENGTH SHORT) .show'() 


} 


可 以 看 到 ,这 里 我 们 一 次 性 申请 了 两 个 运行 时 权限 ， 那 么 就 得 将 这 两 个 权限 都 配置 到 
AndroidManifest.xml 中 才 行 ， 如 下 所 示 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.permissionxtest"> 


<uses-permission android:name="android.permission.CALL PHONE" /> 
<uses-permission android:name="android.permission.READ CONTACTS" /> 


</manifest> 


现在 运行 一 下 PermissionXTest 项 目 ， 会 立即 弹出 权限 申请 对 话 框 ,如 图 16.22 所 示 。 
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\ 


Allow PermissionXTest to make Allow PermissionXTest to access 


your contacts? 


and manage phone calls? 


Allow Allow 


Deny Deny 


图 16.22 ”权限 申请 对 话 框 


由 于 我 们 一 次 性 申请 了 两 个 运行 时 权限 ， 在 授权 完 第 一 个 权限 之 后 ， 又 会 弹出 第 二 个 权限 申请 
的 对 话 框 。 全 部 授权 完成 之 后 才 会 回调 到 request ( ) 方 法 的 Lambda 表 达 式 中 ， 并 弹出 一 条 


Toast 提 示 ， 如 图 16.23 所 示 。 
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9:46 


PermissionXTest 


All permissions are granted 


图 16.23 ”监听 权限 申请 的 结果 
所 有 功能 都 如 同 我 们 所 预期 的 那样 运行 了 。 


当然 ， 如 果 你 后 续 发 现 了 一 些 bug ,或 者 有 任何 新 功能 想 要 添加 到 PermissionX 中 ， 可 以 随时 
对 库 进 行 更 新 。 更 新 的 方式 也 非常 简单 ， 只 需要 升级 publish 闭 包 中 的 版 本 号 即 可 ， 如 下 所 示 : 


publish { 
userOrg 'guolindev' 
groupId 'com.permissionx.guolindev' 
artifactId = 'permissionx' 
publishVersion = '1.0.1' 
desc = 'Make Android runtime permission request easy.' 
website = 'https://github.com/guolindev/PermissionX' 


} 


这 里 我 要 解释 一 下 ， 版 本 号 通常 以 3 位 数字 的 格式 居多 。 其 中 ， 如 果 是 一 些 bug 的 修复 或 者 是 小 
功能 的 修改 ， 应 该 升级 最 后 一 位 版 本 号 。 而 如 果 是 一 些 比较 大 的 功能 或 API 变 更 ， 则 应 该 升级 中 
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间 一 位 版 本 号 。 只 有 涉及 非常 大 的 功能 变更 甚至 是 整体 架构 的 改变 时 ， 才 应 该 升级 第 一 位 版 本 
号 。 


升级 完 版 本 号 之 后 ,只 需要 重新 执行 上 一 节 中 使 用 过 的 发 布 命令 ， 就 可 以 将 新 版 的 库 发 布 到 
jcenter 仓 库 中 了 。 


最 后 ,我 们 还 需要 对 PermissionX 的 GitHub 主 页 进行 更 新 ， 介绍 一 下 PermissionX 的 基本 用 法 
才 行 ， 不 然 别 的 开发 者 将 无 从 得 知 该 如 何 使 用 我 们 的 开源 库 。GitHub 中 开源 库 主 页 的 介绍 是 使 
用 MarkDown 语 法 编写 的 ， 关 于 这 种 语法 ,我 在 这 里 就 不 做 太 多 说 明了 ， 因为 最 常用 的 其 实 也 
就 是 几 个 简单 的 标签 而 已 ， 至 于 完整 的 MarkDown 语 法 格式 ， 你 可 以 参考 : 
https://guides.github.com/features/mastering-markdown., 


那么 ， 现 在 打开 PermissionX 工 程 目 录 下 的 README.md 文 件 ， 并 使 用 如 图 16.24 所 示 的 语法 
格式 编写 一 段 非常 简单 的 用 法 说 明 。 


司 README.md 


# PermissionX 
PermissionX 是 一 个 用 于 简化 Android 运 行 时 权限 用 法 的 开源 库 。 
添加 如 下 配置 将 PermissionX 引 入 到 你 的 项 目 当中 : 


”groovy 
dependencies { 


implementation '‘'com,.permissionx.guolindev:permissionx:1.0.0' 


然后 就 可 以 使 用 如 下 语法 结构 来 申请 运行 时 权限 了 : 
‘~~kotlin 
PermissionX,. request(this, 


Manifest.permission.CALL_PHONE, 
Manifest.permission,.READ_CONTACTS) { allGranted, deniedList -> 


if (allGranted) { 
Toast.makeText (this, "All permissions are granted"，Toast,LENGTH_SHORT) ,show() 


} else{ 
Toast.makeText (this, "You denied $deniedList", Toast.LENGTH_SHORT). show() 


he 


图 16.24 ”编写 PermissionX 的 用 法 说 明 


注意 ,我们 应 该 将 所 有 的 代码 都 放 到 一 对 “标签 中 ， 并 且 在 开始 的 “标签 后 面 加 上 代码 所 使 
用 的 语言 类 型 。 这 样 GitHub 将 会 根据 相应 语言 的 语法 ， 自 动 对 一 些 关键 字 进行 高 亮 显 示 ， 从 而 
让 文档 中 的 代码 看 起 来 更 加 美观 ,也 更 加 适合 阅读 。 


现在 将 README.md 文 件 提交 并 同步 到 GitHub 远 程 仓 库 上 。 


git add . 
git commit -m“" 编 写 PermissionX 的 用 法 说 明 。" 
git push origin master 


然后 刷新 一 下 PermissionX 的 GitHub 主 页 ,现在 就 可 以 看 到 我 们 刚刚 编写 的 PermissionX 用 法 
说 明了 ， 如 图 16.25 所 示 。 


www.blogss.cn 


PermissionX 


PermissionX 是 一 个 用 于 简化 Android 运 行 时 权限 用 法 的 开源 库 。 


添加 如 下 配置 将 PermissionX 引 入 到 你 的 项 目 当中 : 


implementation 'com.permissionx.guolindev:permissionx:1.0.0' 


然后 就 可 以 使 用 如 下 语法 结构 来 申请 运行 时 权限 了 : 


Manifest,. permission, CALL_PHONE, 
Manifest,. permission.READ_CONTACTS) { allGranted, deniedList -> 
if (allGranted) { 
Toast.makeText(this, "All permission 
} else 
Toast.makeText (this, 


s are granted"，Toast,LENGTH_SHORT) .show() 


"You denied $deniedList"，Toast,LENGTH_SHORT) ,show() 


} 
} 


图 16.25 编写 PermissionX 的 用 法 说 明 


到 这 里 ， 本 章 的 内 容 就 全 部 结束 了 。 在 本 章 中 ， 我 们 动手 编写 了 一 个 开源 库 ， 并 成 功 将 它 发 布 
到 了 jcenter 仓 库 ， 这样 任 何 开发 者 都 可 以 在 自己 的 项 目 中 集成 我 们 编写 的 开源 库 ， 从 而 让 项 目 
的 开发 变 得 更 加 简单 。 希 望 你 在 充分 掌握 了 本 章 内 容 之 后 ,也 能 够 为 Android 开 源 社 区 贡献 一 份 
力量 ,开发 出 一 些 更 加 优秀 的 开源 库 ， 让 Android 的 开源 环境 变 得 越 来 越 好 。 


最 后 要 说 明 的 是 ， 我 在 本 章 中 着 重 讲解 的 是 编写 与 发 布 一 个 开源 库 的 整体 流程 ， 并 没有 在 开源 
库 的 实现 细节 上 花 太 多 的 篇 幅 ， 因 此 PermissionX 实 际 上 还 是 一 个 功能 非常 简单 的 库 。 后 期 我 
对 这 个 库 的 功能 进行 了 一 些 扩充 与 完善 ， 使 它 成 为 了 一 个 更 加 强大 的 运行 时 权限 库 ， 你 可 以 访 
问 它 的 GitHub 主 页 来 查看 更 多 新 的 用 法 。 
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16.6 ”结束 语 


就 这 样 ， 本 书 所 有 的 内 容 你 都 学 完了 ! 现在 你 已 经 成 功 毕业 ， 并 且 成 为 了 一 名 合格 的 Android 开 
发 者 。 但 是 ， 如 果 想 要 成 为 一 名 出 色 的 Android 开 发 者 ， 光 靠 本 书 中 的 这 些 理论 知识 以 及 少量 的 
实践 还 是 不 够 的 ， 你 需要 真正 步 入 工作 岗位 中 ， 通 过 更 多 的 项 目 实战 来 不 断 地 历练 和 提升 自 

已 。 

噶 明 了 整 本 书 的 话 ， 但 是 到 了 最 后 却 不 知道 该 说 点 什么 好 。 我 不 想 说 我 能 教 你 的 就 只 有 这 些 

了 ， 因 为 实际 上 我 想 教 你 或 者 和 你 一 起 探讨 的 内 容 还 有 很 多 ， 不 过 限于 篇 幅 的 原因 ， 本 书 的 内 
容 就 只 能 到 此 为 止 了 。 但 我 会 长 期 在 博客 和 微 信 公众 号 上 面 分 享 更 多 Android 相 关 的 技术 文章 ， 
你 如 果 感 兴趣 的 话 ， 可 以 到 我 的 博客 和 公众 号 中 继续 学 习 。 当 然 ， 如 果 是 对 本 书 中 的 内 容 有 疑 
问 ， 可 以 给 我 留言 ， 博 客 地 址 和 微 信 公众 号 见 封面 。 


好 了 ， 就 到 这 里 吧 ， 祝 愿 你 未 来 的 Android 之 旅 都 能 愉快 。 
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看 完了 


如 果 和 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com , 会 有 编辑 或 作 译 者 协助 答 
疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : ebook@turingbook.com。 
在 这 里 可 以 找到 我 们 : 

微 博 @ 图 灵 教 育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview , 讲述 码 农 精彩 人 生 

。 微 信 图 灵 教 育 : turingbooks 
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